TcxCustomPopupEditProperties Class

Stores pop-up editor settings.

Declaration

TcxCustomPopupEditProperties = class(
    TcxCustomDropDownEditProperties
)

Remarks

The TcxCustomPopupEditProperties class implements settings that allow you to embed a control (a TControl class descendant) into the editor’s pop-up or drop-down window.

Main API Members

The list below outlines key members of the TcxCustomPopupEditProperties class that allow you to embed a control into the drop-down window and configure the editor.

• 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 TcxCustomPopupEditProperties Class References

The following public API members reference a TcxCustomPopupEditProperties object:

TcxCustomPopupEdit.ActivePropertiesObtains the properties that are currently applied to an editor.TcxCustomPopupEdit.PropertiesIdentifies the main attributes specific to an editor.

Inheritance

TObject TPersistent TInterfacedPersistent TcxInterfacedPersistent TcxCustomEditProperties TcxCustomTextEditProperties TcxCustomMaskEditProperties TcxCustomDropDownEditProperties TcxCustomPopupEditProperties

See Also

TcxPopupEditProperties Class

TcxCustomPopupEditProperties Members

cxDropDownEdit Unit