\Header{grid.set}{Set a Grid Graphical Object}
\alias{setGrob}{grid.set}
\keyword{dplot}{grid.set}
\begin{Description}\relax
Replace a grob or a descendant of a grob.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.set(gPath, newGrob, strict = FALSE, redraw = TRUE) 
setGrob(gTree, gPath, newGrob, strict = FALSE) 
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{gTree}] A gTree object.
\item[\code{gPath}] A gPath object. For \code{grid.set} this
specifyies a grob on the display list.  For \code{setGrob} this
specifies a descendant of the specified gTree. 
\item[\code{strict}] A boolean indicating whether the gPath must be
matched exactly. 
\item[\code{newGrob}] A grob object. 
\item[\code{redraw}] A logical value to indicate whether to redraw the grob. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{setGrob} copies the specified grob and returns a modified
grob.

\code{grid.set} destructively replaces a grob on the display list.
If \code{redraw}
is \code{TRUE} it then redraws everything to reflect the change.

These functions should not normally be called by the user.
\end{Details}
\begin{Value}
\code{setGrob} returns a grob object;  \code{grid.set} returns \code{NULL}.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\code{\Link{grid.grob}}.
\end{SeeAlso}

