R: Add a Grid Graphical Object

grid.add {grid}

R Documentation

Add a Grid Graphical Object

Description

Add a grob to a gTree or a descendant of a gTree.

Usage

grid.add(gPath, child, strict = FALSE, grep=FALSE, global=FALSE,
         allDevices=FALSE, redraw=TRUE) 
addGrob(gTree, child, gPath = NULL, strict = FALSE, grep=FALSE, global=FALSE)

Arguments

gTree

A gTree object.

gPath

A gPath object. For grid.add this specifyies a gTree on the display list. For addGrob this specifies a descendant of the specified gTree.

child

A grob object.

strict

A boolean indicating whether the gPath must be matched exactly.

grep

A boolean indicating whether the gPath should be treated as a regular expression. Values are recycled across elements of the gPath (e.g., c(TRUE, FALSE) means that every odd element of the gPath will be treated as a regular expression). NOT YET IMPLEMENTED.

global

A boolean indicating whether the function should affect just the first match of the gPath, or whether all matches should be affected. NOT YET IMPLEMENTED.

allDevices

A boolean indicating whether all open devices should be searched for matches, or just the current device. NOT YET IMPLEMENTED.

redraw

A logical value to indicate whether to redraw the grob.

Details

addGrob copies the specified grob and returns a modified grob.

grid.add destructively modifies a grob on the display list. If redraw is TRUE it then redraws everything to reflect the change.

Value

addGrob returns a grob object; grid.add returns NULL.

Author(s)

Paul Murrell