MATLAB Function Reference |
Copy graphics objects and their descendants
Syntax
Description
copyobj
creates copies of graphics objects. The copies are identical to the original objects except the copies have different values for their Parent
property and a new handle. The new parent must be appropriate for the copied object (e.g., you can copy a line object only to another axes object).
new_handle = copyobj(h,p)
copies one or more graphics objects identified by h
and returns the handle of the new object or a vector of handles to new objects. The new graphics objects are children of the graphics objects specified by p
.
Remarks
h
and p
can be scalars or vectors. When both are vectors, they must be the same length, and the output argument, new_handle,
is a vector of the same length. In this case, new_handle(i)
is a copy of h(i)
with its Parent
property set to p(i)
.
When h
is a scalar and p
is a vector, h
is copied once to each of the parents in p
. Each new_handle(i)
is a copy of h
with its Parent
property set to p(i)
, and length(new_handle)
equals length(p)
.
When h
is a vector and p
is a scalar, each new_handle(i)
is a copy of h(i)
with its Parent
property set to p
. The length of new_handle
equals length(h)
.
Graphics objects are arranged as a hierarchy. See Handle Graphics Objects for more information.
Examples
Copy a surface to a new axes within a different figure.
h = surf(peaks); colormap hot figure % Create a new figure axes % Create an axes object in the figure new_handle = copyobj(h,gca); colormap hot view(3) grid on
Note that while the surface is copied, the colormap (figure property), view, and grid (axes properties) are not copies.
See Also
findobj
, gcf
, gca
, gco
, get
, set
Parent
property for all graphics objects
Finding and Identifying Graphics Objects for related functions
copyfile | corrcoef |
© 1994-2005 The MathWorks, Inc.