uitree

Creates a hierarchy in the graphical user interface.

Syntax

h = uitree()

h = uitree(property, value...)

h = uitree(parent, property, value, ...)

Inputs

parent
Optional handle of a container object, which could be a figure, uipanel, uitab or uicontrol of style uibuttongroup. If no handle is given, current figure is used as the parent.
Type: scalar
property, value
'backgroundcolor'
Specifies the background color. Color can be specified as a real vector specifying RGB values in the range 0-255 or 0-1.
Type: string | vector
'callback'
Callback function that is triggered by a single mouse click on h. If value is a function handle, it must be a function that takes two arguments. The first argument is the handle of the uicontrol. The second argument is the event data to the uicontrol. OML passes empty data to the second argument if there is no data to the uicontrol. If value is a string, it must represent a function handle or a function name. If value is a cell, it must contain the function name/function handle in the first cell element and parameters to pass to callback function in the additional elements.
Type: cell | functionhandle | string
'enable'
Specifies if h is enabled. Valid values are 'on'(default) and 'off'.
Type: string
'expand'
Specifies if h is expanded. Valid values are 'on'(default) and 'off'.
Type: string
'fontangle'
Specifies the angle of the displayed font. Valid values are 'regular'(default) and 'italic'.
Type: string
'fontname'
Specifies the name of the displayed font.
Type: string
'fontsize'
Specifies the size of the displayed font.
Type: scalar
'fontweight'
Specifies the weight of the displayed font in all tabs. Valid values are 'normal'(default) and 'bold'.
Type: string
'foregroundcolor'
Specifies the foreground color. Valid values are 'transparent' or a real vector specifying RGB values in the range 0-255 or 0-1.
Type: string | vector
'iconpath'
Path to the icon of the root node.
Type: string
'interruptible'
Specifies if the callback associated with h is interruptible by the user by clicking on the Stop button in the user interface. Valid values are 'off' (default) and 'off'.
Type: string
'parent'.
Specifies the parent handle. This should be a container object like a figure, uipanel, uitab or uicontrol of style buttongroup.
Type: scalar
'position'
Position and size of h. Value is specified as a vector of form: [left top width height]. If 'units' has a value of 'normalized', values must be between 0 to 1.
Type: vector
'tag'
User-defined string to tag graphical control objects.
Type: string
'tooltipstring'
Tooltip to display.
Type: string
'text'
Text displayed for the root node of h. If no value is specified, the text displayed is 'Root'.
Type: string
'units'
Specifies units of measurement. Valid values are 'pixels'(default) and 'normalized'.
'pixel'
Indicates that h has a fixed size and position specified by 'position'.
'normalized'
Indicates that h is resized if parent is resized.
Type: string
'userdata'
User-defined numerical data.
Type: complex | mtx | scalar
'value'
User-defined scalar data.
Type: double | integer
'visible'
Specifies if h is visible. Valid values are 'on'(default) and 'off'.
Type: string

Outputs

h
Handle of the uitree created.

Example

Create a hierarchical tree with internal tree nodes:

h = uitree('text', 'My Tree', 'iconpath', 'msfolder.png', 'foregroundcolor', 'blue', ...
    'fontweight', 'bold');

% Internal node with properties
node1 = uitreenode(h, 'iconpath', 'mslist.png', 'text', 'Node1', 'fontangle', 'italic');

% Default internal node
node2 = uitreenode(h);
set(node2, 'enable', 'off');

% Leaf node
leafnode = uitreenode(node2, 'text', 'Leaf Node');


Figure 1. uitree command