R grid.pack 将对象打包在框架内

说明

这些函数与grid.frame 和frameGrob 一起构成用于构造图形图像的GUI-builder-like 接口的一部分。这个想法是，您使用 grid.frame 或 frameGrob 创建一个框架，然后使用这些函数将对象打包到框架中。

用法

grid.pack(gPath, grob, redraw = TRUE, side = NULL,
          row = NULL, row.before = NULL, row.after = NULL,
          col = NULL, col.before = NULL, col.after = NULL,
          width = NULL, height = NULL,
          force.width = FALSE, force.height = FALSE, border = NULL,
          dynamic = FALSE)

packGrob(frame, grob, side = NULL,
          row = NULL, row.before = NULL, row.after = NULL,
          col = NULL, col.before = NULL, col.after = NULL,
          width = NULL, height = NULL,
          force.width = FALSE, force.height = FALSE, border = NULL,
          dynamic = FALSE)

参数

gPath	一个 gPath 对象，指定显示列表上的一个框架。
frame	类 frame 的对象，通常是调用 grid.frame 的输出。
grob	类 grob 的对象。待包装的物体。
redraw	指示是否应更新输出的布尔值。
side	"left" 、 "top" 、 "right" 、 "bottom" 之一指示将对象打包到哪一侧。
row	将对象添加到哪一行。必须介于 1 和 the-number-of-rows-currently-in-the-frame + 1 或 NULL 之间，在这种情况下，对象占据所有行。
row.before	将对象添加到该行之前的新行中。
row.after	将对象添加到该行之后的新行中。
col	将对象添加到哪个列。必须介于 1 和 the-number-of-cols-currently-in-the-frame + 1 或 NULL 之间，在这种情况下，对象占据所有列。
col.before	将对象添加到此列之前的新列中。
col.after	将对象添加到该列之后的新列中。
width	指定添加对象的列的宽度(而不是允许从对象获取宽度)。
height	指定添加对象的行的高度(而不是允许从对象获取高度)。
force.width	一个逻辑值，指示要装入 grob 的列的宽度是否应该是调用 grid.pack 中指定的宽度，还是该宽度与预先存在的宽度的最大值。
force.height	一个逻辑值，指示将 grob 装入的列的高度应该是调用 grid.pack 中指定的高度，还是该高度与预先存在的高度的最大值。
border	长度为 4 的 unit 对象，指示对象周围的边框。
dynamic	如果宽度/高度取自正在打包的 grob，则此布尔标志指示 grobwidth/height 单位是直接引用 grob，还是使用 gPath 到 grob。在后一种情况下，对 grob 的更改将触发宽度/高度的重新计算。

细节

packGrob 修改给定的帧组并返回修改后的帧组。

grid.pack 破坏性地修改显示列表上的帧组(如果 redraw 是 TRUE 则重绘显示列表)。

这些(本来就是)非常灵活的函数。有许多不同的方法来指定新对象相对于框架中已有对象的添加位置。该函数检查规范是否不是self-contradictory。

请注意，除非指定了 width /height，否则添加对象的行/列的宽度/高度取自对象本身。

值

packGrob 返回帧 grob，但 grid.pack 返回 NULL 。

作者

Paul Murrell

也可以看看

grid.frame、grid.place、grid.edit 和 gPath。