\HeaderA{grid.place}{Place an Object within a Frame}{grid.place}
\aliasA{placeGrob}{grid.place}{placeGrob}
\keyword{dplot}{grid.place}
\begin{Description}\relax
These functions provide a simpler (and faster) alternative
to the \code{grid.pack()} and \code{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.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.place(gPath, grob, row = 1, col = 1, redraw = TRUE)
placeGrob(frame, grob, row = NULL, col = NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{gPath}] A gPath object, which specifies a frame on the
display list.
\item[\code{frame}] An object of class \code{frame}, typically the output
from a call to \code{grid.frame}. 
\item[\code{grob}] An object of class \code{grob}.  The object to be
placed. 
\item[\code{row}] Which row to add the object to.  Must be between 1 and
the-number-of-rows-currently-in-the-frame. 
\item[\code{col}] Which col to add the object to.  Must be between 1 and
the-number-of-cols-currently-in-the-frame.  
\item[\code{redraw}] A boolean indicating whether the output should be updated. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{placeGrob} modifies the given frame grob and returns the modified
frame grob.

\code{grid.place} destructively modifies a frame grob on the display
list (and redraws the display list if \code{redraw} is \code{TRUE}).
\end{Details}
\begin{Value}
\code{placeGrob} returns a frame grob, but \code{grid.place} returns
\code{NULL}.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{grid.frame}{grid.frame}},
\code{\LinkA{grid.pack}{grid.pack}},
\code{\LinkA{grid.edit}{grid.edit}}, and \code{\LinkA{gPath}{gPath}}.
\end{SeeAlso}

