findobj

find an object with specified property

Calling Sequence

h =  findobj(propertyName, propertyValue)

Arguments

:propertyName string character Name of the property to test (case

unsensitive).

: :propertyValue string character specify the value the tested

propoerty should be equal to (case sensitive).

: :h handle of the found object. :

Description

This routine is currently used to find objects knowing their ‘tag’ property. It returns handle of the first found object which property propertyName is equal to propertyValue . If such an object does not exist, the function returns an empty matrix.

Examples

// Create a figure
h=`figure`_();
// Put a text in the figure
`uicontrol`_(h, "style","text", ...
             "string","This is a figure", ...
             "position",[50 70 100 100], ...
             "fontsize",15, ...
             "tag","Alabel");
// Find the object which "tag" value is "Alabel"
lab=findobj("tag","Alabel");
`disp`_("The text of the label is """+lab.string+"""");
// Close the figure
`close`_();

See Also

• uicontrol create a Graphic User Interface object
• uimenu Create a menu or a submenu in a figure
• set set a property value of a graphic entity object or of a User Interface object.
• get Retrieve a property value from a graphics entity or an User Interface object.