findobj

Arguments

propertyName

string character Name of the property to test (case unsensitive).

propertyValue

string character specify the value the tested property 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 — Ajusta um valor de propriedade de uma objeto entidade gráfica ou de um objeto Interface do Usuário (User Interface)
• get — Recupera um valor de propriedade de uma entidade de gráficos ou um objeto Interface do Usuário.