Control element
Contains the controls that appear on each dialog.
Attributes
Bitmap
yesnoThis attribute is only valid for RadioButton and PushButton Controls.
Cancel
yesnoSet this attribute to “yes” to cause this Control to be invoked by the escape key.
CDROM
yesnoThis attribute is only valid for Volume and Directory Controls.
CheckBoxPropertyRef
stringThis 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
stringThis 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
yesnoThis attribute is only valid for ComboBox Controls.
Default
yesnoSet 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
yesnoSet this attribute to “yes” to cause the Control to be disabled.
ElevationShield
yesnoThis 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
yesnoThis attribute is only valid for Volume and Directory Controls.
FixedSize
yesnoThis attribute is only valid for RadioButton, PushButton, and Icon Controls.
Floppy
yesnoThis attribute is only valid for Volume and Directory Controls.
FormatSize
yesnoThis attribute is only valid for Text Controls.
HasBorder
yesnoThis attribute is only valid for RadioButton Controls.
Height
LocalizableInteger requiredHeight of the rectangular boundary of the control. This must be a non-negative number.
Help
stringThis attribute is reserved for future use. There is no need to use this until Windows Installer uses it for something.
Hidden
yesnoSet this attribute to “yes” to cause the Control to be hidden.
HideCondition
When the condition expression evaluates to true, hide the Control.
Icon
yesnoThis 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 requiredCombined with the Dialog Id to make up the primary key of the Control table.
Image
yesnoThis attribute is only valid for RadioButton, PushButton, and Icon Controls.
Indirect
yesnoSpecifies 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
yesnoSet 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
yesnoSet this attribute to “yes” to cause the scroll bar to display on the left side of the Control.
Multiline
yesnoThis attribute is only valid for Edit Controls.
NoPrefix
yesnoThis attribute is only valid for Text Controls.
NoWrap
yesnoThis attribute is only valid for Text Controls.
Password
yesnoThis attribute is only valid for Edit Controls.
ProgressBlocks
yesnoThis attribute is only valid for ProgressBar Controls.
Property
stringThe name of a defined property to be linked to this control. This column is required for active controls.
PushLike
yesnoThis attribute is only valid for RadioButton and Checkbox Controls.
RAMDisk
yesnoThis attribute is only valid for Volume and Directory Controls.
Remote
yesnoThis attribute is only valid for Volume and Directory Controls.
Removable
yesnoThis attribute is only valid for Volume and Directory Controls.
RightAligned
yesnoSet this attribute to “yes” to cause the Control to be right aligned.
RightToLeft
yesnoSet 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
yesnoThis attribute is only valid for VolumeCostList Controls.
Sorted
yesnoThis 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
yesnoSet this attribute to “yes” to cause the Control to be sunken.
TabSkip
yesnoSet this attribute to “yes” to cause this Control to be skipped in the tab sequence.
Text
stringA 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
stringThe string used for the Tooltip.
Transparent
yesnoThis attribute is only valid for Text Controls.
Type
string requiredThe 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
yesnoThis attribute is only valid for Text Controls.
Width
LocalizableInteger requiredWidth of the rectangular boundary of the control. This must be a non-negative number.
X
LocalizableInteger requiredHorizontal coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.
Y
LocalizableInteger requiredVertical coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.