| Reference information | |
|---|---|
| Project page | Dialogs and Billboards |
| Related topics | Working with attribute panes |
| External links | |
A SelectionTree control is a tree control that displays the product features defined on the Components and Features project page. Depending on the features' attributes, the SelectionTree control allows the user to select or remove features for installation.
A SelectionTree control may be linked to an installer property that is also linked to the controls in the folder browse dialog box (by default, this is either AdminBrowseDlg or BrowseDlg); this allows the user to select the installation folder for the currently selected feature.
The Tarma Installer equivalent is the FeatureTree
control.
This pane contains the following attributes and options.
| Attribute | Description |
|---|---|
| Control name | Enter the name of the control. This name has no special significance, but it must be unique among all controls of its parent dialog or billboard. |
| Text aid | Enter text for display by screen readers. This text is not normally visible, but it can be read by screen reader software such as used by visually impaired users. |
| Font |
Select the font style for the text in the control by clicking ... (browse) to open the Select Font Style dialog. |
| Help text | Enter text for display by screen readers. This text is not normally visible, but it can be read by screen reader software such as used by visually impaired users. |
| Property |
Enter the name of the property to which the control must be linked, or click ... (browse) to open the Select Product Variable dialog box that allows you to select a property from the project. The named property should be the same as the one used by the controls in the folder browse dialog box (by default, this is either AdminBrowseDlg or BrowseDlg). |
| Indirect |
Check this box to make the property link indirect; clear it for a direct link. If the link is indirect, the property specified in the Property field is used to obtain the name of a second property, and it is this second property whose value is changed by the control. With a direct link, the property specified by the Property attribute itself is changed. |
| Visible |
Check this box to make the control initially visible; clear it to hide the control. You can change the visibility status of the control at installation time by using Control conditions. |
| Enabled |
Check this box to enable the control initially; clear it to disable the control. An enabled control accepts user input; a disabled control does not and appears grayed out. You can change the enabled status of the control at installation time by using Control conditions. |
| Sunken | Check this box to make the control appear sunken; clear it to display it flush with its parent dialog or billboard. A sunken control has a simulated 3D border. |
| Don't mirror | Check this box to keep the control's orientation as it is and not mirror it for languages that use a right-to-left (RTL) order; clear it to mirror the control if the parent dialog is mirrored for RTL languages. This option only has effect for languages that use an RTL reading order, such as Arabic and Hebrew; for other languages it is ignored. |