TcxPopupEditProperties Class

Stores pop-up editor settings.

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).

Direct TcxPopupEditProperties Class References

The following public API members reference a TcxPopupEditProperties object:

TcxDBPopupEdit.ActivePropertiesTcxDBPopupEdit.PropertiesTcxPopupEdit.ActivePropertiesTcxPopupEdit.Properties

Inheritance

TObject TPersistent TInterfacedPersistent TcxInterfacedPersistent TcxCustomEditProperties TcxCustomTextEditProperties TcxCustomMaskEditProperties TcxCustomDropDownEditProperties TcxCustomPopupEditProperties TcxPopupEditProperties

See Also

TcxPopupEditProperties Members

cxDropDownEdit Unit