#### 15.3.4 Searching Properties

— Function File: h = findobj ()
— Function File: h = findobj (prop_name, prop_value)
— Function File: h = findobj ("-property", prop_name)
— Function File: h = findobj ("-regexp", prop_name, pattern)
— Function File: h = findobj ("flat", ...)
— Function File: h = findobj (h, ...)
— Function File: h = findobj (h, "-depth", d, ...)

> 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.

> See also: get, set.

— Function File: h = findall ()
— Function File: h = findall (prop_name, prop_value)
— Function File: h = findall (h, ...)
— Function File: h = findall (h, "-depth", d, ...)

> 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`.

> See also: get, set, findobj, allchild.