TcxPopupEditProperties Class

Declaration

TcxPopupEditProperties = class(
    TcxCustomPopupEditProperties
)

Remarks

The TcxPopupEditProperties class implements all appearance and behavior settings of unbound and data-aware pop-up editors. You can use the PopupControl property to embed any TControl class descendant into the editor’s pop-up or drop-down window.

Main API Members

The list below outlines key members of the TcxPopupEditProperties class that allow you to configure pop-up editors.

Specify properties that determine editor appearance and behavior settings (AssignedValues).
Validate the edit value (ValidateDisplayValue, ValidateOnEnter, and CanValidate).
Apply a formatting pattern to content in display and edit modes (DisplayFormat and EditFormat).
Limit the maximum number of characters users can enter into the input box (MaxLength).
Enable and define display text when the editor is empty (UseNullString and Nullstring).
Specify editor behavior when validation errors occur (BeepOnError and ValidationOptions).
Enable and configure the input mask (CaseInsensitive, EditMask, IgnoreMaskBlank, and MaskKind).
Enable the drop-down window in read-only mode (AllowDropDownWhenReadOnly).
Display a custom glyph on the drop-down button (ButtonGlyph).
Specify if the drop-down button is in the pressed state while the drop-down window is displayed (KeepArrowButtonPressedWhenDroppedDown).
Embed a control into the drop-down window (PopupControl).
Allow users to resize the drop-down window (PopupSizeable).
Adjust the minimum dimensions of the drop-down window (PopupMinWidth and PopupMinHeight).
Resize the drop-down window (PopupWidth and PopupHeight).
Display the drop-down window in a horizontal or vertical direction from the editor (PopupDirection).
Adjust the drop-down window position horizontally and vertically (PopupHorzAlignment and PopupVertAlignment).
Allow users to apply the current selection to the edit value on a Tab keystroke (PostPopupValueOnTab).
Enable the system panel for the drop-down window (PopupSysPanelStyle).
Display the drop-down window’s non-client border (PopupClientEdge).
Respond to drop-down window open and close operations (OnPopup and OnCloseUp).
Prevent users from closing the drop-down window (OnCloseQuery).
Perform custom actions before the drop-down window opens or closes (OnInitPopup and OnFinalizePopup).
Restore the default appearance and behavior settings (RestoreDefaults).
Select content when the editor receives focus (AutoSelect).
Enable or disable the read-only mode (ReadOnly).
Specify content alignment (Alignment, UseLeftAlignmentOnEditing, and ValidationErrorIconAlignment).
Access the editor’s button collection (Buttons).
Customize the view style of editor buttons (ButtonsViewStyle).
Assign keystrokes to actions (ClearKey and ClickKey).
Manage editor updates (BeginUpdate, EndUpdate, LockUpdate, DoUpdate, Update, Changed, ChangedLocked, and DataChanged).
Specify if the editor always responds to mouse wheel rotation (UseMouseWheel).
Identify classes of the editor’s property values (GetButtonsClass, GetContainerClass, GetStyleClass, and GetViewInfoClass).