TcxDBCheckBox Class
A data-aware check box editor.
Declaration
TcxDBCheckBox = class(
TcxCustomCheckBox
)Remarks
A check box editor allows users to switch between two or three states of an option.
Main API Members
The list below outlines key members of the TcxDBCheckBox class. These members allow you to configure data-aware check box editors.
Appearance Settings
- Style | StyleDisabled | StyleFocused | StyleHot | StyleReadOnly
Allow you to define individual appearance settings for different editor states.
Tip
To apply the same style settings to multiple editors, use a TcxEditStyleController component. If you need to apply the same style settings to all editors in your application, you can use a TcxDefaultEditStyleController component.
- Styles
- Provides access to individual styles applied to the editor in different states.
- Transparent
- Specifies if the check box is transparent in GDI render mode.
Content-Related APIs
- Checked
- Specifies if the editor is checked or unchecked.
- DataBinding
- Allows you to bind the check box editor to data.
- EditValue
- Specifies the edit value.
- State | Toggle
Switch between checked, unchecked, and grayed states.
Note
You need to set the Properties.AllowGrayed property to
Trueto add the grayed (intermediate) state to the check box editor.
Editor Settings and Repository Items
- ActiveProperties
- Provides access to the current check box settings regardless of their source. This property set does not allow you to customize editor settings.
- GetPropertiesClass
- Returns the actual editor settings type.
- Properties
- Allows you to customize check box settings directly if the editor does not have an assigned repository item.
- RepositoryItem
- Specifies a repository item as an external source of check box settings. A repository item has priority over other editor settings.
General-Purpose API Members
- Enabled
- Specifies if the editor is enabled.
- CanModify
Identifies if the editor is in read-only mode.
Tip
You can use the Properties.ReadOnly property to enable or disable read-only mode for the check box editor.
- ShowHint
- Specifies if the standalone editor can display hints.
Repository Item Class
You can create a TcxEditRepositoryCheckBoxItem component in an edit repository to store check box settings and share them between multiple check box editors.