R grid.layout 创建网格布局

说明

该函数返回一个网格布局，它说明了矩形区域的细分。

用法

grid.layout(nrow = 1, ncol = 1,
        widths = unit(rep_len(1, ncol), "null"),
        heights = unit(rep_len(1, nrow), "null"),
        default.units = "null", respect = FALSE,
        just="centre")

参数

nrow	说明布局中行数的整数。
ncol	说明布局中的列数的整数。
widths	说明布局中列宽度的数值向量或单位对象。
heights	说明布局中行的高度的数值向量或单位对象。
default.units	指示 widths 或 heights 仅作为数值向量给出时使用的默认单位的字符串。
respect	逻辑值或数字矩阵。如果符合逻辑，则表明行高和列宽是否应相互尊重。如果是矩阵，非零值表示应遵守相应的行和列(请参见下面的示例)。
just	字符串或数字向量，指定布局与其父视口大小不同时应如何调整布局。如果有两个值，则第一个值指定水平对齐方式，第二个值指定垂直对齐方式。可能的字符串值为： "left" 、 "right" 、 "centre" 、 "center" 、 "bottom" 和 "top" 。对于数值，0 表示左对齐，1 表示右对齐。请注意，在此上下文中，例如 "left" 表示将最左侧布局列的左边与父视口的左边对齐。

细节

为布局的 widths 和 heights 指定的单元对象可以使用仅对布局有意义的特殊 units。这是 "null" 单位，它指示列/行占用的可用宽度/高度的相对分数。有关布局中相对宽度和高度的更好说明，请参阅引用。

值

网格布局对象。

警告

此函数不得与基本 R 图形函数 layout 混淆。特别是，不要将 layout 与网格图形结合使用。 layout 的文档可能提供一些有用的信息，并且该函数在类似情况下的行为应该相同。 grid.layout 函数添加了指定更广泛的行高和列宽单位的函数，并允许嵌套布局(请参阅 viewport )。

例子

## A variety of layouts (some a bit mid-bending ...)
layout.torture()
## Demonstration of layout justification
grid.newpage()
testlay <- function(just="centre") {
  pushViewport(viewport(layout=grid.layout(1, 1, widths=unit(1, "inches"),
                          heights=unit(0.25, "npc"),
                          just=just)))
  pushViewport(viewport(layout.pos.col=1, layout.pos.row=1))
  grid.rect()
  grid.text(paste(just, collapse="-"))
  popViewport(2)
}
testlay()
testlay(c("left", "top"))
testlay(c("right", "top"))
testlay(c("right", "bottom"))
testlay(c("left", "bottom"))
testlay(c("left"))
testlay(c("right"))
testlay(c("bottom"))
testlay(c("top"))

作者

Paul Murrell

参考

Murrell, P. R. (1999). Layouts: A Mechanism for Arranging Plots on a Page. Journal of Computational and Graphical Statistics, 8, 121-134. doi:10.2307/1390924.

也可以看看

Grid、grid.show.layout、viewport、layout