grid.pack {grid}R Documentation

Pack an Object within a Frame

Description

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

Usage

grid.pack(frame, grob, grob.name="", draw=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)

Arguments

frame An object of class frame, typically the output from a call to grid.frame.
grob An object of class grob. The object to be packed.
grob.name The name of the grob within the frame. This is crucial if you intend to access the object again, for example, to edit it.
draw A boolean indicating whether the output should be updated.
side One of "left", "top", "right", "bottom" to indicate which side to pack the object on.
row Which row to add the object to. Must be between 1 and the-number-of-rows-currently-in-the-frame + 1, or NULL in which case the object occupies all rows.
row.before Add the object to a new row just before this row.
row.after Add the object to a new row just after this row.
col Which col to add the object to. Must be between 1 and the-number-of-cols-currently-in-the-frame + 1, or NULL in which case the object occupies all cols.
col.before Add the object to a new col just before this col.
col.after Add the object to a new col just after this col.
width Specifies the width of the column that the object is added to (rather than allowing the width to be taken from the object).
height Specifies the height of the row that the object is added to (rather than allowing the height to be taken from the object).
force.width A logical value indicating whether the width of the column that the grob is being packed into should be EITHER the width specified in the call to grid.pack OR the maximum of that width and the pre-existing width.
force.height A logical value indicating whether the height of the column that the grob is being packed into should be EITHER the height specified in the call to grid.pack OR the maximum of that height and the pre-existing height.
border A unit object of length 4 indicating the borders around the object.

Details

This is (meant to be) a very flexible function. There are many different ways to specify where the new object is to be added relative to the objects already in the frame. The function checks that the specification is not self-contradictory.

NOTE that the width/height of the row/col that the object is added to is taken from the object itself unless the width/height is specified.

Value

None.

Author(s)

Paul Murrell

See Also

grid.frame

Examples






[Package Contents]