User Interface Levels

Windows Installer

User Interface Levels

Windows Installer provides package developers the capability to author an internal user interface that has multiple levels of functionality. Because the internal UI must be created by the author of the package, the behavior of the full UI, reduced UI, basic UI, and None levels depends on the installation package. The following table describes the functionality commonly ascribed to UI levels.

UI Level Description
Full UI Displays modal and modeless dialog boxes that have been authored into the internal UI. Displays authored Error Dialog boxes.

Note  Modal dialog boxes require user input before the installation can continue and are specified by setting the Modal Dialog Style Bit in the Attributes column of the Dialog table. A modeless dialog box does not require user input for the installation to continue.

A full UI commonly exhibits User Interface Wizard Behavior.

Reduced UI Displays any modeless dialog boxes that have been authored into the UI. Does not display any authored modal dialog boxes. Displays authored Error Dialog boxes. Displays Disk Prompt messages. Displays FilesInUse Dialog boxes.
Basic UI Displays the built-in modeless dialog boxes that show progress messages. Displays built-in error dialog boxes. Does not display any authored dialog boxes. Prompts users to insert a disk by displaying a dialog box containing the DiskPrompt property value.
None None means a silent installation that displays no UI.

 

The level of the internal UI can be set using MsiSetInternalUI. The installer sets the UILevel property to the current level of the UI.

If the LIMITUI property is set, the user interface (UI) level used when installing the package is restricted to Basic.

For an example of UI authoring, see An Installation Example.

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.