Windows
Installer documentation| Reference information | |
|---|---|
| Project page | Dialogs and Billboards |
| Related topics | Working with attribute panes |
| External links | Windows
Installer documentation |
An Edit control is an editable text field.
Each Edit control is linked to an installer property and text entered in the control is automatically copied to the property's value. The property itself can be used elsewhere; this allows you to use the Edit control to control the installer's actions or obtain information such as a registration code at installation time.
Tip: Windows Installer also supports MaskedEdit and PathEdit controls for more specialized purposes.
The Tarma Installer equivalent is the EditText
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. |
| Max chars | Enter the maximum number of characters that the user may enter in the Edit control. |
| 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. |
| Font |
Select the font style for the text in the control by clicking ... (browse) to open the Select Font Style dialog. |
| 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 is updated when the user edits the text in the control.. |
| 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. |
| Integer | Check this box if the linked property contains an integer number; clear it if the property contains a text string. |
| 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. |
| Multiline |
Check this box to make the Edit control a multiline control; clear it to restrict it to a single line. Multiline edit controls perform word wrapping if the user enters more text than fits in the width of the control; they also allow the user to enter newline characters (by pressing Ctrl+Enter). This option cannot be combined with Password. |
| Password |
Check this box to hide the text in the Edit control; clear it for visible editing. If this option is checked, all text in the control is displayed as *, even though internally the actual text is used for the linked property. This option is intended to prevent bystanders from reading sensitive information such as passwords. This option cannot be combined with Multiline. |
| 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. |