Control Element

WiX Help

Control Element

Description

None

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
Name Type Description Required
Id String   Yes
Bitmap YesNoType only valid for RadioButton and PushButton Controls  
Cancel YesNoType yes if this is the control invoked on cancel of dialog  
CDROM YesNoType only valid for Volume and Directory Controls  
CheckBoxValue String Only for CheckBox control to set Property to a value on check  
ComboList YesNoType only valid for ComboBox Controls  
Default YesNoType yes if this control invoked by the return key  
Disabled YesNoType    
ElevationShield YesNoType Only valid for PushButton controls. This attribute adds 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.  
Fixed YesNoType only valid for Volume and Directory Controls  
FixedSize YesNoType only valid for RadioButton, PushButton, and Icon Controls  
Floppy YesNoType only valid for Volume and Directory Controls  
FormatSize YesNoType only valid for Text Controls  
HasBorder YesNoType only valid for RadioButton Controls  
Height LocalizableInteger   Yes
Help String    
Hidden YesNoType    
Icon YesNoType only valid for RadioButton and PushButton Controls  
IconSize Enumeration only valid for RadioButton, PushButton, and Icon Controls This attribute's value should be one of the following:
16
32
48
 
Image YesNoType only valid for RadioButton, PushButton, and Icon Controls  
Indirect YesNoType    
Integer YesNoType    
LeftScroll YesNoType    
Multiline YesNoType only valid for Edit Controls  
NoPrefix YesNoType only valid for Text Controls  
NoWrap YesNoType only valid for Text Controls  
Password YesNoType only valid for Edit Controls  
ProgressBlocks YesNoType only valid for ProgressBar Controls  
Property String    
PushLike YesNoType only valid for RadioButton and Checkbox Controls  
RAMDisk YesNoType only valid for Volume and Directory Controls  
Remote YesNoType only valid for Volume and Directory Controls  
Removable YesNoType only valid for Volume and Directory Controls  
RightAligned YesNoType    
RightToLeft YesNoType    
ShowRollbackCost YesNoType only valid for VolumeCostList Controls  
Sorted YesNoType 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 YesNoType    
TabSkip YesNoType yes if this control is skipped in the tab sequence  
Text String    
ToolTip String    
Transparent YesNoType only valid for Text Controls  
Type String   Yes
UserLanguage YesNoType only valid for Text Controls  
Width LocalizableInteger   Yes
X LocalizableInteger   Yes
Y LocalizableInteger   Yes
See Also
Wix Schema