Main Content


Create structure containing all child objects of Figure

Use this function only with GUIDE, or with apps created using the figure function. App Designer is the recommended environment for building apps. For more information, see GUIDE Migration Strategies.


handles = guihandles(object_handle)
handles = guihandles


handles = guihandles(object_handle) returns a structure containing all child objects in a Figure. The object_handle argument can be a Figure object or any child component of a Figure. Any UI or graphics components you placed in the Figure are listed with field names that match their Tag property.

The handles structure typically contains one field for every child object, but there are some exceptions:

  • Objects that have an empty Tag property are not listed.

  • Objects with hidden handles are listed.

  • When multiple objects have the same Tag property, that field in the structure contains a vector of objects.

handles = guihandles returns a structure containing all child objects for the current Figure.

Introduced before R2006a