R grid.edit 编辑网格图形对象的说明

说明

更改 grob 的插槽之一的值并重新绘制 grob。

用法

grid.edit(gPath, ..., strict = FALSE, grep = FALSE,
          global = FALSE, allDevices = FALSE, redraw = TRUE)

grid.gedit(..., grep = TRUE, global = TRUE)

editGrob(grob, gPath = NULL, ..., strict = FALSE, grep = FALSE,
         global = FALSE, warn = TRUE)

参数

grob	一个抓取对象。
...	零个或多个指定新槽值的命名参数。
gPath	一个 gPath 对象。对于grid.edit，这指定显示列表上的一个grob。对于editGrob，这指定了指定 grob 的后代。
strict	一个布尔值，指示 gPath 是否必须完全匹配。
grep	一个布尔值，指示是否应将 gPath 视为正则表达式。值在 gPath 的元素之间循环利用(例如，c(TRUE, FALSE) 意味着 gPath 的每个奇数元素将被视为正则表达式)。
global	一个布尔值，指示该函数是否应仅影响 gPath 的第一个匹配项，或者是否应影响所有匹配项。
warn	指示未能找到指定 gPath 是否应触发错误的逻辑。
allDevices	一个布尔值，指示是否应搜索所有打开的设备以查找匹配项，或者仅搜索当前设备。尚未实现。
redraw	一个逻辑值，指示是否重画 grob。

细节

editGrob 复制指定的 grob 并返回修改后的 grob。

grid.edit 破坏性地修改显示列表上的 grob。如果redraw 是TRUE，它将重绘所有内容以反映更改。

这两个函数都调用 editDetails 以允许 grob 执行自定义操作，并调用 validDetails 以检查修改后的 grob 是否仍然一致。

grid.gedit(g 表示全局)只是具有不同默认值的 grid.edit 的便捷包装。

值

editGrob 返回一个 grob 对象； grid.edit 返回 NULL 。

例子

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")))

作者

Paul Murrell

也可以看看

grob、getGrob、addGrob、removeGrob。