grid.add {grid} | R Documentation |
Add a grob to a gTree or a descendant of a gTree.
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) setChildren(x, children)
gTree, x |
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. |
children |
A gList 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).
|
global |
A boolean indicating whether the function should affect
just the first match of the gPath , or whether all matches
should be affected.
|
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. |
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.
setChildren
is a basic function for setting all children
of a gTree at once (instead of repeated calls to addGrob
).
addGrob
returns a grob object; grid.add
returns NULL
.
Paul Murrell
grob
, getGrob
,
addGrob
, removeGrob
.