Skip to content

Control element

Contains the controls that appear on each dialog.

Attributes

Bitmap

yesno

This attribute is only valid for RadioButton and PushButton Controls.

Cancel

yesno

Set this attribute to “yes” to cause this Control to be invoked by the escape key.

CDROM

yesno

This attribute is only valid for Volume and Directory Controls.

CheckBoxPropertyRef

string

This attribute is only valid for CheckBox controls. The value is the name of a Property that was already used as the Property for another CheckBox control. The Property attribute cannot be specified. The attribute exists to support multiple checkboxes on different dialogs being tied to the same property.

CheckBoxValue

string

This attribute is only valid for CheckBox Controls. When set, the linked Property will be set to this value when the check box is checked.

ComboList

yesno

This attribute is only valid for ComboBox Controls.

Default

yesno

Set this attribute to “yes” to cause this Control to be invoked by the return key.

DefaultCondition

When the condition expression evaluates to true, set the Control as the default.

DisableCondition

When the condition expression evaluates to true, disable the Control.

Disabled

yesno

Set this attribute to “yes” to cause the Control to be disabled.

ElevationShield

yesno

This attribute is only valid for PushButton controls. Set this attribute to “yes” to add the User Account Control (UAC) elevation icon (shield icon) to the PushButton control. If this attribute’s value is “yes” and the installation is not yet running with elevated privileges, the pushbutton control is created using the User Account Control (UAC) elevation icon (shield icon). If this attribute’s value is “yes” and the installation is already running with elevated privileges, the pushbutton control is created using the other icon attributes. Otherwise, the pushbutton control is created using the other icon attributes.

EnableCondition

When the condition expression evaluates to true, enable the Control.

Fixed

yesno

This attribute is only valid for Volume and Directory Controls.

FixedSize

yesno

This attribute is only valid for RadioButton, PushButton, and Icon Controls.

Floppy

yesno

This attribute is only valid for Volume and Directory Controls.

FormatSize

yesno

This attribute is only valid for Text Controls.

HasBorder

yesno

This attribute is only valid for RadioButton Controls.

Height

LocalizableInteger required

Height of the rectangular boundary of the control. This must be a non-negative number.

Help

string

This attribute is reserved for future use. There is no need to use this until Windows Installer uses it for something.

Hidden

yesno

Set this attribute to “yes” to cause the Control to be hidden.

HideCondition

When the condition expression evaluates to true, hide the Control.

Icon

yesno

This attribute is only valid for RadioButton and PushButton Controls.

IconSize

This attribute is only valid for RadioButton, PushButton, and Icon Controls. This attribute’s value must be one of the following:

  • 16
  • 32
  • 48

Id

string required

Combined with the Dialog Id to make up the primary key of the Control table.

Image

yesno

This attribute is only valid for RadioButton, PushButton, and Icon Controls.

Indirect

yesno

Specifies whether the value displayed or changed by this control is referenced indirectly. If this bit is set, the control displays or changes the value of the property that has the identifier listed in the Property column of the Control table.

Integer

yesno

Set this attribute to “yes” to cause the linked Property value for the Control to be treated as an integer. Otherwise, the Property will be treated as a string.

LeftScroll

yesno

Set this attribute to “yes” to cause the scroll bar to display on the left side of the Control.

Multiline

yesno

This attribute is only valid for Edit Controls.

NoPrefix

yesno

This attribute is only valid for Text Controls.

NoWrap

yesno

This attribute is only valid for Text Controls.

Password

yesno

This attribute is only valid for Edit Controls.

ProgressBlocks

yesno

This attribute is only valid for ProgressBar Controls.

Property

string

The name of a defined property to be linked to this control. This column is required for active controls.

PushLike

yesno

This attribute is only valid for RadioButton and Checkbox Controls.

RAMDisk

yesno

This attribute is only valid for Volume and Directory Controls.

Remote

yesno

This attribute is only valid for Volume and Directory Controls.

Removable

yesno

This attribute is only valid for Volume and Directory Controls.

RightAligned

yesno

Set this attribute to “yes” to cause the Control to be right aligned.

RightToLeft

yesno

Set this attribute to “yes” to cause the Control to display from right to left.

ShowCondition

When the condition expression evaluates to true, show the Control.

ShowRollbackCost

yesno

This attribute is only valid for VolumeCostList Controls.

Sorted

yesno

This attribute is only valid for ListBox, ListView, and ComboBox Controls. Set the value of this attribute to “yes” to have entries appear in the order specified under the Control. If the attribute value is “no” or absent the entries in the control will appear in alphabetical order.

Sunken

yesno

Set this attribute to “yes” to cause the Control to be sunken.

TabSkip

yesno

Set this attribute to “yes” to cause this Control to be skipped in the tab sequence.

Text

string

A localizable string used to set the initial text contained in a control. This attribute can contain a formatted string that is processed at install time to insert the values of properties using [PropertyName] syntax. Also supported are environment variables, file installation paths, and component installation directories; see Formatted for details.

ToolTip

string

The string used for the Tooltip.

Transparent

yesno

This attribute is only valid for Text Controls.

Type

string required

The type of the control. Could be one of the following: Billboard, Bitmap, CheckBox, ComboBox, DirectoryCombo, DirectoryList, Edit, GroupBox, Hyperlink, Icon, Line, ListBox, ListView, MaskedEdit, PathEdit, ProgressBar, PushButton, RadioButtonGroup, ScrollableText, SelectionTree, Text, VolumeCostList, VolumeSelectCombo

UserLanguage

yesno

This attribute is only valid for Text Controls.

Width

LocalizableInteger required

Width of the rectangular boundary of the control. This must be a non-negative number.

X

LocalizableInteger required

Horizontal coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.

Y

LocalizableInteger required

Vertical coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.

Children

Binary
Icon referenced in icon column of row
Property
Property table entry for the Property table column associated with this control
Text
Alternative to Text attribute.

Parents

Windows Installer references