TcxCustomDropDownEdit Class
The base class for all editors that can display a drop-down window.
Declaration
TcxCustomDropDownEdit = class(
TcxCustomMaskEdit
)Remarks
A drop-down editor is a single-line editor with a button that invokes a drop-down window. This drop-down window extends data display and edit functionality in an editor-specific manner (for instance, calculator editors display a calculator in a drop-down window, date editors display a calendar, etc.)
Drop-Down Window Interaction
Users can do the following to open or close the drop-down window:
- Click the drop-down button.
- Focus the editor and press the Alt+Up Arrow or Alt+Down Arrow key.
- Focus the editor and press the F4 key.
- Press the Esc key when the drop-down window is displayed.
Main API Members
The list below outlines key members of the TcxCustomDropDownEdit class that allow you to configure drop-down editors and manage their content.
- Identify the actual editor settings class (GetPropertiesClass).
- Display a hint message when the editor is empty (TextHint).
- Customize editor settings (Properties).
- Assign a repository item as an external source of editor settings (RepositoryItem).
- Identify active editor properties (ActiveProperties).
- Disable or enable the editor (Enabled).
- Specify if the editor is transparent in GDI render mode (Transparent).
- Identify if the editor can hide or display its drop-down window (CanHide and CanDropDown).
- Configure look & feel and base editor appearance settings (Style).
- Define individual appearance settings for different editor states (StyleDisabled, StyleFocused, and StyleHot).
- Resize editor dimensions (Width and Height).
- Identify if the editor or its drop-down window has focus (Focused).
- Specify if the editor automatically adjusts its size to fit content (AutoSize).
- Select text (SelLength, SelStart, SetSelection, and SelectAll).
- Invoke or hide the drop-down window (DroppedDown, DropDown, and CloseUp).
- Access the editor’s drop-down window (PopupWindow).
- Clear content selection (ClearSelection).
- Identify if the editor is in read-only mode (CanModify).
- Access and modify editor content (EditingText).
- Undo the last content change while the editor remains focused (Undo).
- Specify if the main single-line editor uses its parent color to fill the background area (ParentColor).
Terminal TcxCustomDropDownEdit Class Descendants
Terminal TcxCustomDropDownEdit class descendants include all unbound and data-aware editors that can display a drop-down window.
Do not create TcxCustomDropDownEdit class instances. Use the following descendants instead:
Unbound Drop-Down Editors
You can use any unbound drop-down editor as a standalone control or as an in-place editor embedded into a container control.
The ExpressEditors Library includes the following unbound drop-down editors:
- TcxBlobEdit
- The BLOB editor.
- TcxCalcEdit
- An editor with a dropdown calculator window.
- TcxComboBox
- An unbound combo box.
- TcxCheckComboBox
- An unbound combo box editor that can display items with check boxes.
- TcxColorComboBox
- Represents a color combo box control.
- TcxDateEdit
- TcxDateEdit is an edit control with a dropdown calendar.
- TcxExtLookupComboBox
- Represents a lookup editor displaying a grid View in its dropdown window.
- TcxFontNameComboBox
- Represents a combo box control containing font names available for selection.
- TcxImageComboBox
- An unbound combo box with support for images.
- TcxLookupComboBox
- Represents a lookup combo box control.
- TcxMRUEdit
- Represents a text editor displaying the list of most recently used items (MRU) within a dropdown window.
- TcxPopupEdit
- Represents a text editor that enables embedding another control in its popup window.
Data-Aware Drop-Down Editors
Data-aware drop-down editors allow you to display and modify field values in the underlying dataset.
Note
If a drop-down editor has both unbound and data-aware versions, you can only use its unbound version as an in-place editor.
The ExpressEditors Library ships with the following data-aware drop-down editors:
- TcxDBBlobEdit
- Represents a data-aware control used for displaying and editing BLOB data from a data source.
- TcxDBCalcEdit
- Represents a data-aware control that enables editing a value via a popup calculator.
- TcxDBComboBox
- A data-aware combo box.
- TcxDBCheckComboBox
- A data-aware combo box editor that can display items with check boxes.
- TcxDBColorComboBox
- Represents the data-aware version of the TcxColorComboBox.
- TcxDBDateEdit
- Represents a data-aware edit control with a dropdown calendar that enables editing date values.
- TcxDBExtLookupComboBox
- Represents a control to edit a dataset field by picking up a record in its dropdown data-aware View.
- TcxDBFontNameComboBox
- Represents a data-aware version of the TcxFontNameComboBox.
- TcxDBImageComboBox
- A data-aware image combo box.
- TcxDBLookupComboBox
- Represents a data-aware editor displaying a set of values from a lookup dataset used for editing values in another dataset.
- TcxDBMRUEdit
- Represents a data-aware text editor that stores the list of most recently used items and allows the selection of a value from this list.
- TcxDBPopupEdit
- Represents a data-aware text editor with a popup window embedding a control.