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

C#

public class PopupBaseEdit :
    ButtonEdit,
    IPopupContentOwner

VB.NET

Public Class PopupBaseEdit
    Inherits ButtonEdit
    Implements IPopupContentOwner

Related API Members

The following members return PopupBaseEdit objects:

• BaseGridColumnHeader.ColumnFilterPopup
• FilterPopupEventArgs.PopupBaseEdit
• PopupBaseEdit.GetPopupOwnerEdit(DependencyObject)

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

• ClosePopupOnClickMode
• IsPopupOpen

Popup Dimensions

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

• PopupHeight
• PopupMinHeight
• PopupMaxHeight
• PopupWidth
• PopupMinWidth
• PopupMaxWidth

Useful API

• ActualPopupWidth
• ActualPopupHeight
• IgnorePopupSizeConstraints

Popup Content

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

• AllowRecreatePopupContent
• PopupFooterButtons

Popup Behavior

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.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PopupBaseEdit class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-add-the-custom-menu-item-to-columns-filter-dropdown-list-e4800/CS/DXGrid.CustomFilter/MainWindow.xaml#L16

<Setter.Value>
    <Style TargetType="dxe:PopupBaseEdit" BasedOn="{StaticResource {dxgt:GridColumnHeaderThemeKey ResourceKey=FilterAreaStyle}}">
        <EventSetter Event="PopupClosed" Handler="OnPopupClosed" />

Reporting_wpf-report-designer-how-to-customize-a-controls-smart-tag-t554855/CS/App.xaml#L30

<dxlc:LayoutItem Label="{dxrud:ReportDesignerStringId StringId=Properties_Expression}">
    <dxe:PopupBaseEdit EditValue="{Binding ProgressBinding, UpdateSourceTrigger=PropertyChanged}"
                       ValidateOnEnterKeyPressed="True"

how-to-hide-filter-buttons-in-column-headers-e20031/VB/MainWindow.xaml#L19

<ControlTemplate x:Key="emptyTemplate" />
<Style x:Key="{dxgt:GridColumnHeaderThemeKey ResourceKey=FilterAreaStyle, IsThemeIndependent=true}" TargetType="{x:Type dxe:PopupBaseEdit}">
    <Setter Property="Foreground" Value="{dxi:ThemeResource {dxgt:GridColumnHeaderThemeKey ResourceKey=FilterPopupForegroundBrush}}" />

Inheritance

Show 40 items

Object

DispatcherObject

DependencyObject

Visual

UIElement

FrameworkElement

Control

BaseEdit

TextEditBase

TextEdit

ButtonEdit

PopupBaseEdit

AutoSuggestEdit

DateEdit

LookUpEditBase

MemoEdit

PopupCalcEdit

PopupColorEdit

PopupImageEdit

TimeZoneEdit

ResourcesPopupCheckedListBoxControl

ResourcesComboBoxControl

LookUpEdit

FontEdit

ComboBoxEdit

TimeZoneEdit

ItemComboBoxEdit

DurationEdit

AppointmentStatusEdit

AppointmentResourcesEdit

AppointmentResourceEdit

AppointmentLabelEdit

PopupBrushEdit

AppointmentLabelEdit

AppointmentResourceEdit

AppointmentResourcesEdit

AppointmentStatusEdit

MonthEdit

WeekDaysEdit

WeekOfMonthEdit

Extension Methods

GetErrorOperationCommands(Position)

GetErrorOperationCommands(Int32)

GetErrorOperationCommands(Point)