Share via


Properties for the User Interface Editor

The following properties are available when working in the User Interface Editor. The actual properties available at any given time are dependent on the deployment project type and the current selection in the editor.

List of Properties

Note

These properties apply only to the user interface dialog boxes that are included in Visual Studio. Dialog boxes that are added by means of the Import Dialog command may have additional properties; the author of the dialog box should document these properties.

Property

Description

Arguments

Specifies command-line arguments for an executable file invoked from a Register User dialog box.

BannerBitmap

Specifies a bitmap or JPEG image to be displayed on a user interface dialog box. For more information, see BannerBitmap Property.

BannerText

Specifies text to be displayed in the banner area of a user interface dialog box.

BodyText

Specifies text to be displayed in the body of a user interface dialog box.

ButtonNLabel

Specifies the label text for a RadioButton control on a user interface dialog box, where N is the number of the RadioButton control.

ButtonNValue

Specifies the value assigned to the ButtonProperty property of a user interface dialog box when a RadioButton control is selected, where N is the number of theRadioButton control.

ButtonProperty

Specifies a property name used to retrieve the value of the selected RadioButton control on a user interface dialog box.

CheckboxNLabel

Specifies the label text for a CheckBox control on a user interface dialog box, where N is the number of the CheckBox control.

CheckboxNProperty

Specifies a property name used to retrieve the value of a CheckBox control on a user interface dialog box, where N is the number of the CheckBox control.

CheckboxNValue

Specifies a default value (Checked or Unchecked) for a CheckBox control on a user interface dialog box, where N is the number of the CheckBox control.

CheckboxNVisible

Determines whether a CheckBox control on a user interface dialog box will be visible during installation, where N is the number of the CheckBox control. All CheckBox controls are visible by default.

CopyrightWarning

Specifies text for a copyright notice to be displayed on the Welcome dialog box. For more information, see CopyrightWarning Property.

DefaultValue

Specifies which RadioButton control in a user interface dialog box will be selected by default. It must match the ButtonNValue property of one of the RadioButton controls on the dialog box.

EditNLabel

Specifies the label text for a TextBox control on a user interface dialog box, where N is the number of the TextBox control.

EditNProperty

Specifies a property name used to retrieve the value of a TextBox control on a user interface dialog box, where N is the number of the TextBox control.

EditNValue

Specifies a default value for a TextBox control on a user interface dialog box, where N is the number of the TextBox control.

EditNVisible

Determines whether a TextBox control on a user interface dialog box will be visible during installation, where N is the number of the TextBox control. All TextBox controls are visible by default.

Executable

Specifies an executable file to be launched from a Register User dialog box. For more information, see Executable Property.

InstallAllUsersVisible

Determines whether the Install MyApplication for yourself, or for anyone who uses this computer label and corresponding Everyone and Just me option buttons appear in the Installation Folder dialog box. For more information, see InstallAllUsersVisible Property.

LicenseFile

Specifies a document to be displayed in a License Agreement dialog box. For more information, see LicenseFile Property.

ReadmeFile

Specifies a document to be displayed in a Read Me dialog box. For more information, see ReadmeFile Property.

SerialNumberTemplate

Specifies a template used to validate serial number entry on a Customer Information dialog box. For more information, see SerialNumberTemplate Property.

ShowOrganization

Determines whether the Organization field will be displayed on a Customer Information dialog box.

ShowProgressBar

Determines whether a progress bar will be displayed on a Progress dialog box.

ShowSerialNumber

Determines whether the Serial Number field will be displayed on a Customer Information dialog box. For more information, see ShowSerialNumber Property.

SplashBitmap

Specifies a bitmap or JPEG image to be displayed on a Splash dialog box. For more information, see SplashBitmap Property.

Sunken

Determines whether to display a sunken border around the bitmap image on a Splash dialog box or the display area of a License Agreement or Read Me dialog box.

UpdateText

Specifies text to be displayed on the Finish dialog box to inform the user about the availability of updates. For more information, see UpdateText Property.

WelcomeText

Specifies text to be displayed in the body of a Welcome dialog box.

See Also

Reference

Windows Installer Deployment Properties

Other Resources

Editors Used in Deployment