A newer version of this page is available. Switch to the current version.

PopupBaseEdit Class

Serves as a base for classes that represent popup editors (e.g. DateEdit, ComboBoxEdit).

Namespace: DevExpress.Xpf.Editors

Assembly: DevExpress.Xpf.Core.v19.1.dll

Declaration

public class PopupBaseEdit :
    ButtonEdit,
    IPopupContentOwner

The following members accept/return PopupBaseEdit objects:

Remarks

The PopupBaseEdit class implements basic functionality for editors that can display a drop-down window.

TIP

The PopupBaseEdit class inherits its features from the ButtonEdit class.

Refer to the ButtonEdit class description for information on derived features and API.

Open and Close Popup

Open Popup

The ShowPopup() method invokes the editor popup. You can open a popup using the OpenPopupCommand.

The PopupOpening event occurs right before the popup is actually opened. After the dropdown has been shown, the editor fires the PopupOpened event.

Close Popup

The CancelPopup() method closes the editor’s popup window, discarding all the changes made.

To programmatically hide the editor’s popup window and save the changes, use the PopupBaseEdit.ClosePopup method. You can also close a popup using the ClosePopupCommand.

The PopupClosing event occurs right before the popup is actually closed. After the dropdown has been closed, the editor fires the PopupClosed event.

Useful API

The following properties allow you to specify the drop-down window dimensions:

Useful API

The PopupContentTemplate property allows you to specify the drop-down window content.

Use the PopupElement property to get the control placed to the drop-down window (for example, for the PopupCalcEdit, the PopupElement property returns a Calculator). The PopupRoot allows you to get a root element within the popup.

Useful API

You can make an editor focus its popup on opening. To do this, set the FocusPopupOnOpen property to true.

The ShowSizeGrip property allows you to enable a size grip, so your end user can resize the popup window.

popupbaseedit show size grip

See Also