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