Control element

Contains the controls that appear on each dialog.

Windows Installer references

Control Table, ComboBox Table, Dialog Table, ListBox Table, ListView Table, RadioButton Table

Parents

Billboard, Dialog

Children

• Binary (no more than 1) : Icon referenced in icon column of row
• ComboBox
• ListBox
• ListView
• Property (no more than 1) : Property table entry for the Property table column associated with this control
• Publish
• RadioButtonGroup
• Subscribe
• Text (no more than 1) : Alternative to Text attribute.

Attributes

Bitmap (YesNoTypeUnion) : This attribute is only valid for RadioButton and PushButton Controls.

Cancel (YesNoTypeUnion) : Set this attribute to "yes" to cause this Control to be invoked by the escape key.

CDROM (YesNoTypeUnion) : 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 (YesNoTypeUnion) : This attribute is only valid for ComboBox Controls.

Default (YesNoTypeUnion) : 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 (YesNoTypeUnion) : Set this attribute to "yes" to cause the Control to be disabled.

ElevationShield (YesNoTypeUnion) : 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 (YesNoTypeUnion) : This attribute is only valid for Volume and Directory Controls.

FixedSize (YesNoTypeUnion) : This attribute is only valid for RadioButton, PushButton, and Icon Controls.

Floppy (YesNoTypeUnion) : This attribute is only valid for Volume and Directory Controls.

FormatSize (YesNoTypeUnion) : This attribute is only valid for Text Controls.

HasBorder (YesNoTypeUnion) : 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 (YesNoTypeUnion) : Set this attribute to "yes" to cause the Control to be hidden.

HideCondition () : When the condition expression evaluates to true, hide the Control.

Icon (YesNoTypeUnion) : This attribute is only valid for RadioButton and PushButton Controls.

IconSize (enumeration) : 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 (YesNoTypeUnion) : This attribute is only valid for RadioButton, PushButton, and Icon Controls.

Indirect (YesNoTypeUnion) : 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 (YesNoTypeUnion) : 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 (YesNoTypeUnion) : Set this attribute to "yes" to cause the scroll bar to display on the left side of the Control.

Multiline (YesNoTypeUnion) : This attribute is only valid for Edit Controls.

NoPrefix (YesNoTypeUnion) : This attribute is only valid for Text Controls.

NoWrap (YesNoTypeUnion) : This attribute is only valid for Text Controls.

Password (YesNoTypeUnion) : This attribute is only valid for Edit Controls.

ProgressBlocks (YesNoTypeUnion) : 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 (YesNoTypeUnion) : This attribute is only valid for RadioButton and Checkbox Controls.

RAMDisk (YesNoTypeUnion) : This attribute is only valid for Volume and Directory Controls.

Remote (YesNoTypeUnion) : This attribute is only valid for Volume and Directory Controls.

Removable (YesNoTypeUnion) : This attribute is only valid for Volume and Directory Controls.

RightAligned (YesNoTypeUnion) : Set this attribute to "yes" to cause the Control to be right aligned.

RightToLeft (YesNoTypeUnion) : 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 (YesNoTypeUnion) : This attribute is only valid for VolumeCostList Controls.

Sorted (YesNoTypeUnion) : 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 (YesNoTypeUnion) : Set this attribute to "yes" to cause the Control to be sunken.

TabSkip (YesNoTypeUnion) : 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 (YesNoTypeUnion) : 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 (YesNoTypeUnion) : 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.

Edit the schema for this page