Skip to main content
Version: v3

Control Element

Description
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
Inner Text
None
Children
Sequence (min: 1, max: 1)
  1. Text (min: 0, max: 1): alternative to Text attribute when CDATA is needed to escape XML delimiters
  2. ComboBox (min: 0, max: 1): ComboBox table with ListItem children
  3. ListBox (min: 0, max: 1): ListBox table with ListItem children
  4. ListView (min: 0, max: 1): ListView table with ListItem children
  5. RadioButtonGroup (min: 0, max: 1): RadioButton table with RadioButton children
  6. Property (min: 0, max: 1): Property table entry for the Property table column associated with this control
  7. Binary (min: 0, max: 1): Icon referenced in icon column of row
  8. Choice of elements (min: 0, max: unbounded)
    • Condition (min: 0, max: unbounded): Condition to specify actions for this control based on the outcome of the condition.
    • Publish (min: 0, max: unbounded)
    • Subscribe (min: 0, max: unbounded)
Attributes
NameTypeDescriptionRequired
IdStringCombined with the Dialog Id to make up the primary key of the Control table.Yes
BitmapYesNoTypeThis attribute is only valid for RadioButton and PushButton Controls. 
CancelYesNoTypeSet this attribute to "yes" to cause this Control to be invoked by the escape key. 
CDROMYesNoTypeThis attribute is only valid for Volume and Directory Controls. 
CheckBoxPropertyRefStringThis 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. 
CheckBoxValueStringThis attribute is only valid for CheckBox Controls. When set, the linked Property will be set to this value when the check box is checked. 
ComboListYesNoTypeThis attribute is only valid for ComboBox Controls. 
DefaultYesNoTypeSet this attribute to "yes" to cause this Control to be invoked by the return key. 
DisabledYesNoTypeSet this attribute to "yes" to cause the Control to be disabled. 
ElevationShieldYesNoType 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.  
FixedYesNoTypeThis attribute is only valid for Volume and Directory Controls. 
FixedSizeYesNoTypeThis attribute is only valid for RadioButton, PushButton, and Icon Controls. 
FloppyYesNoTypeThis attribute is only valid for Volume and Directory Controls. 
FormatSizeYesNoTypeThis attribute is only valid for Text Controls. 
HasBorderYesNoTypeThis attribute is only valid for RadioButton Controls. 
HeightLocalizableIntegerHeight of the rectangular boundary of the control. This must be a non-negative number.Yes
HelpStringThis attribute is reserved for future use. There is no need to use this until Windows Installer uses it for something. 
HiddenYesNoTypeSet this attribute to "yes" to cause the Control to be hidden. 
IconYesNoTypeThis attribute is only valid for RadioButton and PushButton Controls. 
IconSizeEnumerationThis attribute is only valid for RadioButton, PushButton, and Icon Controls. This attribute's value must be one of the following:
16
32
48
 
ImageYesNoTypeThis attribute is only valid for RadioButton, PushButton, and Icon Controls. 
IndirectYesNoTypeSpecifies 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. 
IntegerYesNoTypeSet 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. 
LeftScrollYesNoTypeSet this attribute to "yes" to cause the scroll bar to display on the left side of the Control. 
MultilineYesNoTypeThis attribute is only valid for Edit Controls. 
NoPrefixYesNoTypeThis attribute is only valid for Text Controls. 
NoWrapYesNoTypeThis attribute is only valid for Text Controls. 
PasswordYesNoTypeThis attribute is only valid for Edit Controls. 
ProgressBlocksYesNoTypeThis attribute is only valid for ProgressBar Controls. 
PropertyStringThe name of a defined property to be linked to this control. This column is required for active controls. 
PushLikeYesNoTypeThis attribute is only valid for RadioButton and Checkbox Controls. 
RAMDiskYesNoTypeThis attribute is only valid for Volume and Directory Controls. 
RemoteYesNoTypeThis attribute is only valid for Volume and Directory Controls. 
RemovableYesNoTypeThis attribute is only valid for Volume and Directory Controls. 
RightAlignedYesNoTypeSet this attribute to "yes" to cause the Control to be right aligned. 
RightToLeftYesNoTypeSet this attribute to "yes" to cause the Control to display from right to left. 
ShowRollbackCostYesNoTypeThis attribute is only valid for VolumeCostList Controls. 
SortedYesNoTypeThis 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.  
SunkenYesNoTypeSet this attribute to "yes" to cause the Control to be sunken. 
TabSkipYesNoTypeSet this attribute to "yes" to cause this Control to be skipped in the tab sequence. 
TextStringA 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. 
ToolTipStringThe string used for the Tooltip. 
TransparentYesNoTypeThis attribute is only valid for Text Controls. 
TypeStringThe 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, VolumeSelectComboYes
UserLanguageYesNoTypeThis attribute is only valid for Text Controls. 
WidthLocalizableIntegerWidth of the rectangular boundary of the control. This must be a non-negative number.Yes
XLocalizableIntegerHorizontal coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.Yes
YLocalizableIntegerVertical coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.Yes
See Also
Wix Schema