findobj

Syntax

findobj(propertyName, propertyValue, ...)

findobj(propertyName, propertyValue, '-operator', propertyName, propertyValue)

findobj('-property', propertyName)

findobj(handleList, propertyName, propertyValue, ...)

findobj(handleList, '-depth', depth, ...)

findobj(handleList, 'flat', ...)

Inputs

propertyName

Property name. If the property name is following the keyword '-property' then the search will return all objects that have this property.

Type: string

propertyValue

Value of the property.

Type: double | char | logical | struct | cell | integer

Dimension: scalar | vector | matrix

-operator

A logical operator that is applied on the pair of properties and values. Valid values are: '-and', '-or', '-xor' and '-not'.

Type: string

handleList

Vector of the handles.

Type: double | integer

Dimension: vector

depth

Limits the search to a certain object hierarchy depth. A depth of 0 will limit the search to the objects in the given handleList.

Type: integer

Dimension: scalar

'flat'

Keyword 'flat' will limit the search to the objects in the given handleList.

Type: integer

Dimension: scalar

Examples

Simple findobj example:

findobj('tag', 'user-defined');

Find all objects that have the property 'xdata':

findobj('-property', 'xdata');

Find objects that are colored red or have the marker 'o':

findobj('color', [255 0 0], '-or', 'marker', 'o');

Limit the search to the children of a figure object:

findobj(gcf, '-depth', 1, 'tag', 'user-defined');

Comments

To find objects that satisfy multiple property conditions, specify additional propertyName and propertyValue parameters. The search can be limited to a subset of objects and their descendants by passing a handle or a handles list as the first parameter.