RadioButton Table

[This is preliminary documentation and subject to change.]

Radio buttons are not treated as individual controls, but they are part of a radio button group that functions as a control. The RadioButton table lists the buttons for all the groups.

The RadioButton table has the following columns.

Column	Type	Key	Nullable

Property	Identifier	Y	N
Order	Integer	Y	N
Value	Formatted		N
X	Integer		N
Y	Integer		N
Width	Integer		N
Height	Integer		N
Text	Formatted		Y
Help	Text		Y

Columns

Property: A named property to be tied to this radio button. All the buttons tied to the same property become part of the same group.
Order: A positive integer used to determine the ordering of the items within one list. The integers do not have to be consecutive.
Positive numbers only.
Value: The value string associated with this button. Selecting the button sets the associated property to this value.
X: The horizontal coordinate within the group of the upper-left corner of the bounding rectangle of the radio button.
Non-negative numbers only.
Y: The vertical coordinate within the group of the upper-left corner of the bounding rectangle of the radio button.
Non-negative numbers only.
Width: The width of the button.
Non-negative numbers only.
Height: The height of the button.
Non-negative numbers only.
Text: The visible title to be assigned to the radio button. If the text is too long to be displayed on the control, it is truncated. If the button displays an icon or a bitmap, this entry contains the name of the picture (a key into the Binary table). There is no way to show both a picture and text on a button.
Help: The Help strings used with the button. The text is optional. The string is divided into two parts, divided by a separator character (|). The first part of the string is used as ToolTip text (this text is shown by screen readers for controls that contain a picture). The second part is used for context-sensitive Help. The separator character is required even if only one of the two kinds of text is present.

Remarks

The integer values for x, y, width, and height are in the installer units, not dialog units. An installer unit is equal to one-twelfth the height of the system font. Coordinates for the controls are relative to the billboard.

Positioning

The coordinates of the buttons are given relative to the group. If the coordinates of the group are changed, the buttons within the group remain in the same relative position to each other.

Formatting

The contents of the Value and Text fields are formatted by the MsiFormatRecord function when the control is created, so they can contain any expression that the MsiFormatRecord function can interpret. The formatting occurs only when the control is created, and it is not updated if a property involved in the expression is modified during the life of the control.