grid.edit {grid} | R Documentation |
Changes the value of one of the slots of a grob and redraws the grob.
grid.edit(gPath, ..., strict = FALSE, redraw = TRUE) editGrob(grob, gPath = NULL, ..., strict = FALSE)
grob |
A grob object. |
... |
Zero or more named arguments specifying new slot values. |
gPath |
A gPath object. For grid.edit this
specifyies a grob on the display list. For editGrob this
specifies a descendant of the specified grob. |
strict |
A boolean indicating whether the gPath must be matched exactly. |
redraw |
A logical value to indicate whether to redraw the grob. |
editGrob
copies the specified grob and returns a modified
grob.
grid.edit
destructively modifies a grob on the display list.
If redraw
is TRUE
it then redraws everything to reflect the change.
Both functions call editDetails
to allow a grob to perform
custom actions and validDetails
to check that the modified grob
is still coherent.
editGrob
returns a grob object; grid.edit
returns NULL
.
Paul Murrell
grob
, getGrob
,
addGrob
, removeGrob
.
grid.newpage() grid.xaxis(name="xa", vp=viewport(width=.5, height=.5)) grid.edit("xa", gp=gpar(col="red")) # won't work because no ticks (at is NULL) try(grid.edit(gPath("xa", "ticks"), gp=gpar(col="green"))) grid.edit("xa", at=1:4/5) # Now it should work try(grid.edit(gPath("xa", "ticks"), gp=gpar(col="green")))