OptionTree control

An OptionTree control is a tree control that displays the product's components defined on the Components project page. Depending on the components' attributes, the OptionTree control allows the user to select or remove components for installation.

Tip: To change the tab and Z-order of a control in a dialog box (i.e., the order in which they are drawn and how they appear "on top" of each other), select the control in the dialog/control tree in the left pane on the Dialogs project page, then use Ctrl+Up and Ctrl+Down to move the control up or down in the order. These keystrokes are shortcuts for the Move Up and Move Down commands on the control's context menu.

Attributes

The following attributes and options are available.

Attribute Description
Control name Enter the internal name for the control. This name is for use in InstallMate only; it is not used in the installer. All control names must be unique within their parent dialog box.
Control ID

Select a control ID from the drop-down list or type a numerical ID to use for this control. All controls within a dialog must have different control IDs. For most controls, you should select Automatic; for PushButton controls, one of the standard IDxxx values is generally recommended.

See Dialog control IDs for an explanation of the available control IDs and their usage.

Has buttons Check this box to display +/- buttons in the tree control for branches that can be expanded/collapsed; clear it to omit them. In the latter case, tree branches can still be expanded or collapsed by double-clicking on them.
Has lines Check this box to display connecting lines between tree branches; clear it to omit them.
Lines at root Check this box to display buttons or lines at the left-most (root) level; clear it to omit them. This option only has effect if Has buttons or Has lines are also checked.
Font Select the font style for the text in the control by clicking ... (browse) to open the Select Font Style dialog. If no font style is selected, the control uses the parent dialog's font style. You can remove the font style by clicking X (clear).
Enabled
Tab stop
Group
Border
Sunken
Client edge
Visible
Transparent
Don't mirror

These are all standard control styles; see Dialog control styles for a description.

Condition Enter the display condition for the control or leave empty to display the control unconditionally. See Dialog control conditions for more information.

Related topics

Components, Dialogs, Working with attribute panes