grid (version 3.1.3)

grid.place: Place an Object within a Frame

Description

These functions provide a simpler (and faster) alternative to the grid.pack() and packGrob functions. They can be used to place objects within the existing rows and columns of a frame layout. They do not provide the ability to add new rows and columns nor do they affect the heights and widths of the rows and columns.

Usage

grid.place(gPath, grob, row = 1, col = 1, redraw = TRUE)
placeGrob(frame, grob, row = NULL, col = NULL)

Arguments

gPath

A gPath object, which specifies a frame on the display list.

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 placed.

row

Which row to add the object to. Must be between 1 and the-number-of-rows-currently-in-the-frame.

col

Which col to add the object to. Must be between 1 and the-number-of-cols-currently-in-the-frame.

redraw

A boolean indicating whether the output should be updated.

Value

placeGrob returns a frame grob, but grid.place returns NULL.

Details

placeGrob modifies the given frame grob and returns the modified frame grob.

grid.place destructively modifies a frame grob on the display list (and redraws the display list if redraw is TRUE).

See Also

grid.frame, grid.pack, grid.edit, and gPath.