\HeaderA{grid.get}{Get a Grid Graphical Object}{grid.get}
\aliasA{getGrob}{grid.get}{getGrob}
\aliasA{grid.gget}{grid.get}{grid.gget}
\keyword{dplot}{grid.get}
\begin{Description}\relax
Retrieve a grob or a descendant of a grob.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.get(gPath, strict = FALSE, grep = FALSE, global = FALSE,
         allDevices = FALSE)

grid.gget <- function(..., grep = TRUE, global = TRUE)

getGrob(gTree, gPath, strict = FALSE, grep = FALSE, global = FALSE) 
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{gTree}] A gTree object.
\item[\code{gPath}] A gPath object. For \code{grid.get} this
specifyies a grob on the display list.  For \code{getGrob} this
specifies a descendant of the specified gTree. 
\item[\code{strict}] A boolean indicating whether the gPath must be
matched exactly. 
\item[\code{grep}] A boolean indicating whether the \code{gPath} should
be treated as a regular expression.  Values are recycled across
elements of the \code{gPath} (e.g., \code{c(TRUE, FALSE)} means
that every odd element of the \code{gPath} will be treated as
a regular expression).

\item[\code{global}] A boolean indicating whether the function should affect
just the first match of the \code{gPath}, or whether all matches
should be affected.

\item[\code{allDevices}] A boolean indicating whether all open devices
should
be searched for matches, or just the current device.
NOT YET IMPLEMENTED.

\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{grid.gget} (\code{g} for global) is just a convenience wrapper for
\code{grid.get} with different defaults.
\end{Details}
\begin{Value}
A grob object.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{grob}{grob}}, \code{\LinkA{getGrob}{getGrob}},
\code{\LinkA{addGrob}{addGrob}}, \code{\LinkA{removeGrob}{removeGrob}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
grid.xaxis(name="xa")
grid.get("xa")
grid.get(gPath("xa", "ticks"))

grid.draw(gTree(name="gt", children=gList(xaxisGrob(name="axis"))))
grid.get(gPath("gt", "axis", "ticks"))
\end{ExampleCode}
\end{Examples}

