grid.frame {grid}R Documentation

Create a Frame for Packing Objects

Description

This function, together with grid.pack is part of a GUI-builder-like interface to constructing graphical images. The idea is that you create a frame with this function then use grid.pack to pack objects into the frame.

Usage

grid.frame(layout=NULL, vp=NULL, gp=gpar(), draw=FALSE)

Arguments

layout A Grid layout, or NULL. This can be used to initialise the frame with a number of rows and columns, with initial widths and heights, etc.
vp An object of class viewport, or NULL.
gp An object of class gpar; typically the output from a call to the function gpar.
draw Should the frame be drawn. Nothing will actually be drawn, but it will put the frame on the display list, which means that the output will be dynamically updated as objects are packed into the frame. Possibly useful for debugging.

Value

An object of class "grob".

Author(s)

Paul Murrell

See Also

grid.pack

Examples

grid.newpage()
gf <- grid.frame(draw=TRUE)
grid.pack(gf, grid.rect(draw=FALSE, gp=gpar(fill="grey")))
grid.pack(gf, grid.text("hi there", draw=FALSE), side="right")

[Package Contents]