TdxDBToggleSwitch Class
A data-aware toggle switch editor.
#Declaration
TdxDBToggleSwitch = class(
TdxCustomToggleSwitch
)
#Remarks
A toggle switch is a touch-friendly equivalent of a check box. Three available thumb positions in a toggle switch editor correspond to checked, unchecked, and intermediate states of a check box editor.
Users can drag the thumb, click the editor, or press the Space character when the editor has focus to switch between available check states.
#Main API Members
The list below outlines key members of the TdxToggleSwitch
class. These members allow you to configure toggle switch 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 Tcx
Edit component. If you need to apply the same style settings to all editors in your application, you can use a TcxStyle Controller Default component.Edit Style Controller - Styles
- Provides access to individual styles applied to the editor in different states.
- Transparent
- Specifies if the editor is transparent in GDI render mode.
#Editor State-Related APIs
- Checked | State
Specify the toggle switch editor’s state.
Note
The intermediate editor state is available only if the Properties.
Allow property is set toGrayed True
.- DataBinding
- Allows you to bind the toggle switch editor to data.
- EditValue
- Specifies the edit value.
- OnEditing
- Allows you to prevent users from activating the editor.
#Editor Settings and Repository Items
- ActiveProperties
- Provides access to the current editor 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 editor settings directly if the editor does not have an assigned repository item.
- RepositoryItem
- Specifies a repository item as an external source of editor 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.
- IsEditValidating | IsHiding | IsPosting
- Allow you to identify the current operation in the editor.
- ShowHint
- Specifies if the editor can display hints.
- Width | Height
- Allow you to explicitly define editor dimensions.
#Repository Item Class
You can create a TcxEditRepositoryToggleSwitchItem component in an edit repository to define an unbound toggle switch editor, store editor settings, and share them between multiple toggle switch editors.
#Limitations
You cannot use a data-aware toggle switch editor as an in-place editor in container controls. You can embed only the TdxToggleSwitch component as an in-place editor.