Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.1 - Русский

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

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

Справка Scilab >> GUI > findobj


find an object with specified property


h = findobj()
h = findobj(propertyName, propertyValue)
h = findobj(propertyName, propertyValue, operator, propertyName, propertyValue, ...)
h = findobj("-property", propertyName, ...)
h = findobj(searchHandles, ...)
h = findobj(..., '-depth', d, ...)
h = findobj(..., '-flat', ...)



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


character string specify the value the tested property should be equal to (case sensitive).


character string belonging to the set {"-and", "-or", "-not"}.


Vector of graphic handles where the search is restricted to.


positive integer, the depth of the search.


handles of the found objects.


Without arguments findobj returns handles of all graphic objects and their descendants. If such an object does not exist, the function returns an empty matrix.

findobj(propertyName, propertyValue, ...) returns the handles of objects having the property propertyName set to propertyValue. If successive property/vaue pairs are given the handles of objects verifing all conditions are returned, i.e. there is an implicit "-and" operator between pairs. Another operator can be explicitely given with findobj(propertyName, propertyValue, operator, propertyName, propertyValue, ...).

The priority of evaluations in a composite condition using operators can be controlled by using a cell argument, e.g. findobj({propertyName, propertyValue, ...}, operator, ...)

findobj("-property", propertyName, ...) returns the handles of objects having the property propertyName. Other conditions can be added.

By default the search is done within all figures and findobj(searchHandles, ...) restricts the search to the given handles. The depth of the search is by default infinite and can be restricted by findobj(searchHandles, '-depth', d, ...). A value of 0 restricts the search to objects given in searchHandles and does not search within descendants, this is equivalent to the "flat" optional string.


// Create a figure
// Put a text in the figure
uicontrol(h, "style","text", ...
             "string","This is a figure", ...
             "position",[50 70 100 100], ...
             "fontsize",15, ...
// Find the object which "tag" value is "Alabel"
disp("The text of the label is """+lab.string+"""");
// Create a figure
// plot something
xlabel abscissae
ylabel ordinate
title "a plot"
legend "c1" "c2" "c3"

// Find the objects having a "font_size" property
h1 = findobj("-property","font_size")
// Change the font size of all text objects
h1.font_size = 3

// Find the objects having a "thickness" property
h2 = findobj("-property","thickness")
// Change the thickness of such objects
h2.thickness = 2

See also

  • uicontrol — create a Graphic User Interface object
  • uimenu — Create a menu or a submenu in a figure
  • set — set properties of some graphic objects or uimenus or uicontrol interactive components
  • get — Gets the handle of a graphical or User Interface object, or the property's value of objects.
Report an issue
<< figure GUI gcbo >>

Copyright (c) 2022-2024 (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:
Mon Jan 03 14:39:58 CET 2022