Text Area Control

Enter a name for this text area. The name must be unique among all of the controls in your project.

If this is the only control on the dialog that will dismiss the dialog, select True. Clicking the cancel control has the same effect as pressing the ESC key or clicking the Close button on the title bar. The Cancel or Finish button is usually the cancel control.

This value is ignored if True is selected for the ErrorDialog setting of the dialog that contains this control.

This setting is reserved for future use. Windows Installer does not currently support launching context-sensitive help topics from the installation.

If this is the only control on the dialog that you want to be the default control, which means that it is activated when the end user presses the ENTER key, select True. The Next or OK button is usually the default control.

If you want the installation to attempt to display the value that is entered in the Text setting in bytes, select True. If you select True, the Text setting must contain only a number, without the unit. Then, at run time, it is divided by 512 and displayed as the correct number of kilobytes, megabytes, or gigabytes, depending on the size.

Specify the distance from the left edge of the dialog to the start of the control in installer units (1/12 of the height of the system font).

If the Text setting contains an ampersand that should be displayed as an ampersand character (&), select True.

If you are using the ampersand in the Text setting to indicate that the letter that follows the ampersand should be underlined (for example, &Click would be displayed as Click), select False.

Enter the name of a property that can supply the initial value for the text. This property can be unique to this control; it does not need to be present in the Property Manager view.

For English and other languages that are written from left to right, select False. For Hebrew and those languages that are read from right to left, select True.

Assign an integer that—along with the other controls on this dialog but excluding controls such as static text—specifies the order in which each control on the dialog receives focus when the end user presses the TAB key. The lowest tab index that you can use is the number 0.

This setting contains the text that is shown inside the control.

When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.

Enter the text that you want to be displayed when the end user places the mouse pointer over the control.

When you type a value for this setting, you are creating a string entry and setting its initial value for all of the languages that are currently in the project. As an alternative to typing a new value, you can click the ellipsis button (...) in this setting to select an existing string. For more information, see Using String Entries in InstallShield.

If you want the background to show through this control, select True.

Note that you may want to avoid making this control transparent if you are placing it on top of a colored bitmap. The text may not be visible if end users change the color scheme of their display. For example, the text in this control may become invisible if an end user sets the high-contrast parameter for accessibility reasons.