[This is preliminary documentation and subject to change.]
This control is a group of radio buttons. It enables the user to select a value of a property from a pre-authored list of choices. The possible values are read from the RadioButton Table. Note that the string displayed is not necessarily the same as the value that the user is choosing. The implementation treats the whole group as one control, therefore it is not possible to hide or disable individual buttons within the group. Similarly all the buttons have to be of the same style, that is, either all of them have text or all of them have bitmaps, or other similar features. The position of the buttons is authored relative to the group. This way the entire group can be moved by changing only the coordinates of the group without changing the individual buttons. At creation the control verifies that the individual buttons do not extend beyond the boundaries of the group.
If the Bitmap or the Icon style bit is set, the corresponding text entry in the RadioButton Table is taken as a foreign key to the Binary table that specifies the binary data needed to create the picture on the individual buttons.
This means that the buttons cannot have both a picture and text.
Because of the way Windows draws the frame, there is a gap between the top of the control's window and the visible frame, even when there is no caption.
The property associated with this control can be string or integer valued.
Bitmap
Enabled
FixedSize
HasBorder
Icon
IconSize
ImageHandle
Indirect
Integer
PushLike
Sunken
Visible
Default
Enabled
Indirect
IndirectPropertyName
Position
PropertyName
PropertyValue
Text
Visible
WindowHandle
None.
Yes.
The group is created using the "BUTTON" class. If the HasBorder style is set, it has the BS_GROUPBOX style, otherwise it has the BS_OWNERDRAW style.
The individual buttons are created with the "BUTTON" class.
It has the BS_RADIOBUTTON, WS_CHILD, WS_GROUP, WS_TABSTOP, WS_EX_CONTROLPARENT and BS_MULTILINE styles.
If the PushLike style is set they have the BS_PUSHLIKE style.
If the Bitmap style is set they have the BS_BITMAP style.
If the Icon style is set they have the BS_ICON style.