MSI Factory 2.3

Dialog Settings

Dialog Settings

Previous topic Next topic  

Dialog Settings

Previous topic Next topic  

MSI Factory

Identification

Dialog ID:

The unique identifier of the dialog.

Title:

The localizable title bar text of the dialog.

Position (Percent of Screen)

X:

The horizontal positioning of the dialog on the screen. If left empty, it will default to centered.

Y:

The vertical positioning of the dialog on the screen. If left empty, it will default to centered.

Size (Installer Units)

Width:

The width of the dialog in installer units. An installer unit is approximately equal to one-twelfth (1/12) the height of the 10-point MS Sans Serif font size. The actual size of the dialog in pixels can vary depending on the user's font settings.

Height:

The height of the dialog in installer units. An installer unit is approximately equal to one-twelfth (1/12) the height of the 10-point MS Sans Serif font size. The actual size of the dialog in pixels can vary depending on the user's font settings.

Options

Modeless

If checked, the dialog is modeless meaning that other dialogs in the installation may be moved on top of it. After a modeless dialog is created and displayed, the user interface returns control to the installer. The installer then calls the user interface periodically to update the dialog and to give it a chance to process the messages. As soon as this is done, the control is returned to the installer. If not checked, 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. Most dialogs that you create for your installer will be modal and will not have this options selected.

System modal

If checked, the dialog will stop all other applications and no other applications can take the focus. This state remains until the dialog is dismissed.

Keep modeless

If checked, other modeless dialogs will not be destroyed when this dialog is created. The default is to leave this unchecked which means that modeless dialogs will be destroyed when this dialog is created.

No minimize

If checked, the dialog cannot be minimized. If unchecked, it can be minimized. This option will only be used for modeless dialogs.

Left scroll

If checked, the scroll bar is located on the left side of the dialog.

Right aligned

If this checked, the text is aligned on the right side of the dialog.

Right to left

If checked, the text in the dialog is displayed in right-to-left-reading order.

Custom palette

If checked, the images on the dialog are created with the custom palette (one per dialog received from the first control created). If unchecked, the images are rendered using a default palette. Typically one would use this option if the dialog contains an image with a special palette, or several images sharing a custom palette. This option should not be set if the dialog contains several images with different palettes. In this case, the default palette is most likely to give a satisfactory result for all images.

Error dialog

If checked, the dialog box is an error dialog. Normally you will not need to set this as MSI Factory adds an error dialog to your installer projects by default. If you do check this option, your dialog needs to follow special guidelines in order to accommodate error handling properly. See the "Error Dialog Style Bit" topic in the More Information section below for a more thorough explanation.

Hidden

If checked, the dialog is created as hidden.

Track disk space

If checked, the dialog 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. If the user switches to another application, adds or removes files, or otherwise modifies available disk space, you can quickly implement the change using this style.

More Information

MSDN Online: Dialog Table

MSDN Online: Error Dialog Style Bit

WiX Help File: Dialog Element


Learn More: Indigo Rose Software - MSI Factory - Buy Now - Contact Us