Select Install Folder Screen

The Select Install Folder screen's properties dialog contains the following four tabs of properties you can set:

Settings

Instructions

Text:

The instruction text you want to appear in the body of the screen.

Space Requirements

Show space required

Automatically calculate and display the amount of disk space the installation requires.

Text:

The text that you want to display with the amount of space that the current installation configuration requires. Usually this should be something like "Space required on drive: %SpaceRequired%".

Note: The session variable %SpaceRequired% is used on this screen to store the required space value. This variable must exist in this text for the calculated value to be shown.

Note: Using the ampersand character (&) in the text will make the character to its right a mnemonic key for the control.

Show space available

Automatically calculate and display the amount of free disk space the user has on the current drive.

Text:

The text that you want to display with the amount of free space the user has on the their system. Usually this should be something like "Space available on selected drive:  %SpaceAvailable%".

Note: The session variable %SpaceAvailable% is used on this screen to store the space available value. This variable must exist in this text for the calculated value to be shown.

Note: Using the ampersand character (&) in the text will make the character to its right a mnemonic key for the control.

Install Folder

Prompt:

The text that you want to display directly above the install folder field.

Note: Using the ampersand character (&) in a prompt's text will make the character to its right a mnemonic key for the control.

Default folder:

The default text that you want to appear in the install folder field. In general this should be the session variable %AppFolder%.

Store result in session variable:

The custom session variable you want to use to store the text in the edit field. In general this should be the built-in session variable %AppFolder%.

Enabled

Enable the install folder field so it responds to user interaction. When the edit field is disabled, it will appear greyed out and cannot be edited by the user.

Browse Button

Text:

The text you want to display on the folder browse button.

Note: Using the ampersand character (&) in a button's text will make the character to its right a mnemonic key for the control.

Enabled

Enable the browse button. If unchecked, the browse button will be disabled.

Visible

Set the initial visibility of the browse button (whether it's visible when the screen is displayed).

Language

Language:

The supported language you want to translate the screen text for. You can click the select button ( ) to select a different language currently supported in your setup.

Note: You can add additional language support from the Languages dialog which can be accessed by going to Project > Languages...

 

Tip: You can see how the screen will look at runtime by clicking the Preview button.

Attributes

The screen's attributes tab contains generic settings such as its design-time name, window title, banner style and text and various button settings. The details of this tab's contents are explained in the Screen Attributes topic.

 

Style

The Style tab is used to customize the screen's appearance beyond the global project theme.

Override project theme

Override the global project theme in order to customize the appearance of the current screen. These settings are the same as the Theme Properties dialog, except they only affect the current screen.

Note: Unchecking this option after changes have been made will restore the default theme settings. Any changes made to these settings will be lost.

Tip: If you are editing a screen and you have the Override project theme selected, you can right click on the screen preview and select "Save as Theme..." to save the created theme.

 

Actions

The Actions tab contains the action editor dialog where you can add actions or scripts to each event supported by the screen.

Note: Some events will already contain action script and should not be modified unless you want to customize the default behavior of the screen.

The Select Install Folder screen contains the following screen events:

Tip: You can use the On Ctrl Message event to detect and respond to user interaction. See the Advanced topic for the list of control IDs and string IDs that are available on this screen.

Tip: You can click on one of the event names above for a full description.