The Properties page

This pane displays the attributes of the selected dialog or control. You have the possibility to edit some of these properties.

The Properties pane contains a list of all the controls that belong to the currently selected dialog. When selecting a control in this list, the control is also selected on the dialog and the list is populated with it's properties.

Modifying a property

Click on the attribute you want to edit and make the necessary change. Use the Enter key to validate a modification and the Esc key to delete it.

The properties are grouped in the following categories:

Identification

Contains the following properties:

• Type - This field displays the type of the control. It cannot be edited.
• Name - Displays the control identifier.

Display

This category contains different sets of properties depending on the type of the selected control.

If the control displays a text it has the following property:

• Text - Specify the controls caption. This field is of Formatted Type. Use the [ ... ] to display the Edit Formatted Type Dialog which will allow you to insert a reference to a property. You can localize this string.

If the control displays an image the category contains the following properties:

• Use Indirection - Specify whether the image is specified directly on indirect.
• Picture Path - If indirect is FALSE the picture is specified directly. Use the [ ... ] to select it.
• Indirect Property - If indirect is TRUE a property is used to specify the picture. Use the [ ... ] button to choose a property. These properties are defined in the Images page.

Text Style

In this category you can specify the text style used when displaying the control's caption.

• Use Indirection - Specify whether text style is specified directly on indirect.
• Text Style - If indirect is FALSE the text style is specified directly. Select one from the list of already defined styles.
• Indirect Property - If indirect is TRUE a property is used to specify the text style. Use the [ ... ] button to choose a property. These properties are defined in the Text Styles page.

Print

This option category is available only for "PushButton" controls from a dialog that contains at least a "ScrollableText" control.

The following attributes are available:

• Print Button - Enable this option to indicate that the selected button should trigger the print action.
• Control - When a PushButton control is a "print button" you must choose a ScrollableText control on the same dialog which will contain the text to print.

Value

This category is available for: Check Box, Radio Button, Edit, Path Edit, Directory Combo and Masked Edit controls.

• Value - In this field you can specify the value of the property associated with this control or control group (Radio Buttons group) after the state of the control had been changed. This field is of Formatted Type. Use the [ ... ] to display the Edit Formatted Type Dialog which will allow you to insert a reference to a property.
• Default Value - Default value for the associated property. Available for Check Box controls.
• Selected - Set the default state of the control. Available for Radio Button controls.

Property

Specify the name of the property associated with the currently selected control. You can directly edit the name of the property or use the [ ... ] button to select an existing one.

The property must be public (all uppercase letters) because properties that are to be set by the user interface during the installation and then passed to the execution phase of the installation must be public.

Attributes

Attributes specific to the dialog:

• Modal - If this flag is set, the dialog box is modal, other dialogs of the same application cannot be put on top of it, and the dialog keeps the control while it is running.
• Minimize - The dialog can be minimized.
• SystemModal - This flag is set, the dialog no other applications can take the focus. This state remains until the dialog is dismissed.
• KeepModeless - If true, the other dialogs stay alive when this dialog box is created.
• Track Disk Space - If true, the dialog box periodically calls the installer. If the property changes, it notifies the controls on the dialog. This style can be used if there is a control on the dialog indicating disk space.
• Use Custom Palette - If true, the pictures on the dialog box are created with the custom palette otherwise pictures are rendered using a default palette.
• Error - Make the dialog an error dialog.

Specify the attributes of the control.

• Visible - Specify if by default the control is visible on the dialog.
• Sunken - Specify if the control is displayed sunken.
• Enabled - Specify if by default the control is enabled.
• Indirect - Specify whether the value displayed or modified the this control is indirectly referenced. If this flag is set to TRUE, the control displays or changes the value of the property that has the identifier listed in the Property Name filed. If this flag is FALSE the control displays or changes the value of the property in the Property Name filed.
• Integer - If this flag is set, the associated property is an integer.
• Left Scroll - The scroll bar is displayed on the left of the control.
• Right Aligned - The text of the control is right aligned.
• RTLRO - The text in the control is displayed in a right to left reading order.
• BiDi - A combination of the right to left reading order RTLRO, the Right Aligned, and Left Scroll attributes.
• Text Type - Select what the control will display text, bitmap or icon.
• Push Like - The button is drawn with the appearance of a push button, but its logic stays the same.
• Progres95 - The progress the bar is drawn as a series of small rectangles in Microsoft Windows 95-style.
• Has Border - the Radio Button Group has text and a border displayed around it.
• Show Rollback - Specify whether or not the rollback backup files are included in the costs displayed by the Volume Cost List control.
• Fixed Size - The picture on the control is cropped or centered in the control without changing its shape or size.

The following attributes are available for Text type controls.

• Format Size - If this flag is set for a static text control, the control automatically attempts to format the displayed text as a number that represents a count of bytes. For proper formatting, the control's text must be set to a string that represents a number expressed in units of 512 bytes. The displayed value is then formatted in kilobytes (KB), megabytes (MB), or gigabytes (GB), and displayed with the appropriate string that represents the units.
• No Prefix - If TRUE the occurrence of the character "&" in a text is displayed as itself. If FALSE, then the character following "&" in the text string is displayed as an underscored.
• No Wrap - The text is displayed on a single line. If the length of the string exceeds the dimension of the control then ("...") is inserted at the end to indicate the truncation.
• Password - Creates an edit control for entering passwords.
• Transparent - The control is displayed transparent.
• Users Language - If true fonts are created using the user's default UI code page. If false fonts are created using the database code page.
• Multiline - The installer creates a multiple line edit control with a vertical scroll bar.

The following attributes are available for the Volume and Directory SelectCombo control types.

• CDROM Volume - The control shows all the volumes in the current installation plus all the CD-ROM volumes.
• Fixed Volumes - The control shows all the volumes involved in the current installation plus all the fixed internal hard drives.
• Floppy Volume - The control shows all the volumes involved in the current installation plus all the floppy volumes.
• RAM Disk Volume - The control shows all the volumes involved in the current installation plus all the RAM disk volumes.
• Remote Volume - The control shows all the volumes involved in the current installation plus all the remote volumes.
• Removable Volume - The control shows all the volumes involved in the current installation plus all the removable volumes.

These attributes are available for List Box and Combo Box controls

• Combo list - If this flag is set the edit field of a Combo Box is replaced by a static text field. This prevents a user from entering a new value and requires the user to choose only one of the predefined values.
• Sorted - The items listed in the control are displayed in a specified order otherwise they are displayed in alphabetical order.

Help

Specify the tooltip associated with a control. You can localize this string.

Layout

Edit the layout of the control.

• X - Horizontal coordinate of the upper-left corner of the control.
• Y - Vertical coordinate of the upper-left corner of the control.
• Width - Width of the control.
• Height - Height of the control.

These values have a maximum limit. You will not be able to enter a value greater than that limit.

These values are specified in installer units.