TcxCustomDropDownEdit Class

The base class for all editors that can display a drop-down window.

Declaration

delphi

TcxCustomDropDownEdit = class(
    TcxCustomMaskEdit
)

Remarks

A drop-down editor is a single-line editor with a button that displays 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 + ↑ or Alt + ↓ 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. These members 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).
Display 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:

TcxBlobEditThe BLOB editor.TcxCalcEditAn editor with a dropdown calculator window.TcxComboBoxAn unbound combo box.TcxCheckComboBoxAn unbound combo box editor that can display items with check boxes.TcxColorComboBoxRepresents a color combo box control.TcxDateEdit TcxDateEdit is an edit control with a dropdown calendar.TcxExtLookupComboBoxRepresents a lookup editor displaying a grid View in its dropdown window.TcxFontNameComboBoxRepresents a combo box control containing font names available for selection.TcxImageComboBoxAn unbound combo box with support for images.TcxLookupComboBoxRepresents a lookup combo box control.TcxMRUEditRepresents a text editor displaying the list of most recently used items (MRU) within a dropdown window.TcxPopupEditRepresents 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:

TcxDBBlobEditRepresents a data-aware control used for displaying and editing BLOB data from a data source.TcxDBCalcEditRepresents a data-aware control that enables editing a value via a popup calculator.TcxDBComboBoxA data-aware combo box.TcxDBCheckComboBoxA data-aware combo box editor that can display items with check boxes.TcxDBColorComboBoxRepresents the data-aware version of the TcxColorComboBox.TcxDBDateEditRepresents a data-aware edit control with a dropdown calendar that enables editing date values.TcxDBExtLookupComboBoxRepresents a control to edit a dataset field by picking up a record in its dropdown data-aware View.TcxDBFontNameComboBoxRepresents a data-aware version of the TcxFontNameComboBox.TcxDBImageComboBoxA data-aware image combo box.TcxDBLookupComboBoxRepresents a data-aware editor displaying a set of values from a lookup dataset used for editing values in another dataset.TcxDBMRUEditRepresents a data-aware text editor that stores the list of most recently used items and allows the selection of a value from this list.TcxDBPopupEditRepresents a data-aware text editor with a popup window embedding a control.

Inheritance

Show 14 items

TObject TPersistent TComponent TControl TWinControl TCustomControl TcxCustomControl TcxControl TcxContainer TcxCustomEditContainer TcxCustomEdit TcxCustomTextEdit TcxCustomMaskEdit TcxCustomDropDownEdit