Next: Managing Default Properties, Previous: Graphics Object Properties, Up: Graphics Data Structures [Contents][Index]
Find graphics object with specified property values. The simplest form is
findobj (prop_name, prop_value)
which returns all of the handles to the objects with the name
prop_name and the name prop_value. The search can be limited
to a particular object or set of objects and their descendants by
passing a handle or set of handles h as the first argument to
findobj
.
The depth of hierarchy of objects to which to search to can be limited with the "-depth" argument. To limit the number depth of the hierarchy to search to d generations of children, and example is
findobj (h, "-depth", d, prop_name, prop_value)
Specifying a depth d of 0, limits the search to the set of object passed in h. A depth d of 0 is equivalent to the "-flat" argument.
A specified logical operator may be applied to the pairs of prop_name and prop_value. The supported logical operators are "-and", "-or", "-xor", "-not".
The objects may also be matched by comparing a regular expression to the
property values, where property values that match regexp
(prop_value, pattern)
are returned. Finally, objects may be
matched by property name only, using the "-property" option.
Find graphics object with specified property values including hidden handles.
This function performs the same function as findobj
, but it
includes hidden objects in its search. For full documentation, see
findobj
.
Next: Managing Default Properties, Previous: Graphics Object Properties, Up: Graphics Data Structures [Contents][Index]