The TcxCheckBox component represents a check box that lets the user select an option. Unlike the TcxRadioGroup component that lets the user select only one of the mutually exclusive options, a group of TcxCheckBox components lets the user choose several options at once.

The check box can have two states (checked and unchecked) or three states (checked, unchecked and grayed). Whether the check box can have three states is specified by the Properties.AllowGrayed property. The check state can be determined or set via the Checked or State property. The difference in these properties is that Checked lets you specify only checked and unchecked states whereas State lets you also specify the intermediate (grayed) state.

Other properties of the TcxCheckBox object let you adjust the check box behavior, appearance and other attributes.

TcxCheckBox Properties

Name	Description
`Align`	Specifies how the component is aligned within its parent.
`Anchors`	Specifies how the component is anchored to its parent.
`AutoSize`	Specifies whether the component is automatically resized to display its entire contents.
`Caption`	Specifies the panel caption text.
`Checked`	Specifies whether the check box is checked.
`ChildControl`	Returns the child component specified by its index.
`ChildControlByName`	Returns the child component by name.
`ChildControlCount`	Returns the child component specified by index.
`ClientHeight`	Returns the height of the component’s client area.
`ClientWidth`	Returns the width of the component’s client area.
`Constraints`	Specifies the component’s size constraints.
`Cursor`	Specifies the cursor’s image when it is situated over the component.
`Enabled`	Specifies whether the component is enabled.
`Height`	Specifies the component’s height.
`Hint`	Specifies the text displayed when the cursor stays over the component.
`Left`	Specifies the horizontal coordinate of the component’s left edge.
`Name`	Specifies the component’s name.
`ParentBackground`	Specifies whether the component uses its parent’s theme background.
`ParentColor`	Specifies whether the component uses the same background color as its parent.
`ParentFont`	Specifies whether the component uses the same font as its parent.
`ParentShowHint`	Specifies whether the component uses the parent’s `ShowHint` property value instead of its own one.
`Properties`	Returns the `TcxCheckBoxProperties` object which holds specific properties of a check box component.
`Property`	Obtains or sets the value of the property specified by its index.
`PropertyByName`	Obtains or sets the value of the property with the specified name.
`PropertyCount`	Returns the number of component’s properties.
`PropertyName`	Returns the property name by index.
`ShowHint`	Specifies whether to display the component’s hint.
`State`	Specifies the check box state.
`Style`	Specifies the style of the component.
`TabOrder`	Specifies the component’s tab index.
`TabStop`	Specifies whether the component can be selected by the `Tab` key.
`Top`	Specifies the vertical coordinate of the component’s top edge.
`Transparent`	Specifies whether the component’s background is transparent.
`Visible`	Specifies whether the component is visible on screen.
`Width`	Specifies the component’s width.

TcxCheckBox Methods

TcxCheckBox Events

Name	Description
`PropertyExists`	Checks to whether the component has the property with the specified name.
`SetFocus`	Moves the input focus to the component.

Name	Description
`OnFocusChanged`	Occurs when the component receives or loses the input focus.
`OnChange`	Occurs when the check state of a check box is changed.
`OnEditValueChanged`	Occurs when the check state of a check box is changed.
`OnClick`	Occurs when the component is clicked.
`OnEnter`	Occurs when the component receives the input focus.
`OnExit`	Occurs when the component loses the input focus.
`OnMouseEnter`	Occurs when the mouse pointer enters the component.
`OnMouseLeave`	Occurs when the mouse pointer leaves the component.

TcxCheckBox Object

See Also