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。