CheckBox Control

[This is preliminary documentation and subject to change.]

This control is a simple two-state check box. If the CheckBox table exists and specifies a value for the property associated with the checkbox, the property is set to this value when the checkbox is on, to null otherwise. If there is no such table, or it does not specify a value for this property, but the associated property has an initial value, the control remembers it and initially drawn as selected. When the control is unchecked, the property is set to NULL. If the check box is rechecked, it returns to its original value. If the property does not have an original value, it is set to "1" when the control is checked.

Property

The property associated with this control can be integer or string valued.

Valid Style Bits

Bitmap
Enabled
FixedSize
Icon
IconSize
ImageHandle
Indirect
Integer
PushLike
Sunken
Visible

Valid Control Attributes

Default
Enabled
Indirect
IndirectPropertyName
Position
PropertyName
PropertyValue
Text
Visible
WindowHandle

Control Events Published

None.

Can Take Focus

Yes.

Remarks

The control is created with the "BUTTON" class.

It has the BS_CHECKBOX, WS_TABSTOP, WS_GROUP, WS_CHILD and BS_MULTILINE styles.

If the PushLike style is set it has the BS_PUSHLIKE style.

If the Bitmap style is set it has the BS_BITMAP style.

If the Icon style is set it has the BS_ICON style.