grid.set {grid}R Documentation

Set a Grid Graphical Object


Replace a grob or a descendant of a grob.


grid.set(gPath, newGrob, strict = FALSE, grep = FALSE, redraw = TRUE) 
setGrob(gTree, gPath, newGrob, strict = FALSE, grep = FALSE) 


gTree A gTree object.
gPath A gPath object. For grid.set this specifyies a grob on the display list. For setGrob this specifies a descendant of the specified gTree.
newGrob 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).
redraw A logical value to indicate whether to redraw the grob.


setGrob copies the specified grob and returns a modified grob.

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

These functions should not normally be called by the user.


setGrob returns a grob object; grid.set returns NULL.


Paul Murrell

See Also


[Package grid version 2.1.0 Index]