Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.1 - English

Change language to:
Français - 日本語 - Português

Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab help >> GUI > findobj

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.

Authors

Bertrand Guiheneuf

V.C.

<< figure GUI gcbo >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Mar 03 10:59:46 CET 2011