PopupBaseEdit.PopupContentTemplate Property

Gets or sets the template that defines the presentation of the popup window’s content. This is a dependency property.

Namespace: DevExpress.Xpf.Editors

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

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public ControlTemplate PopupContentTemplate { get; set; }

VB.NET

Public Property PopupContentTemplate As ControlTemplate

Property Value

Type	Description
ControlTemplate	A ControlTemplate object that represents the template of the popup window’s content.

Remarks

The PopupContentTemplate property allows you to specify the popup window content.

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

Set the AllowRecreatePopupContent property to true to recreate the popup content each time the editor displays its popup.

Example

This example shows how to customize the GridControl displayed in the LookUpEdit‘s popup window.

1. Set the LookUpEdit.AutoPopulateColumns property to false.
2. Use the PopupBaseEdit.PopupContentTemplate property to specify a custom GridControl.
3. Set the GridControl‘s name to PART_GridControl.

View Example: LookUpEdit - Customize the Embedded GridControl

XAML

<dxg:LookUpEdit Name="lookUpEdit1"
                DisplayMember="ProductName"
                ValueMember="ID"
                AutoPopulateColumns="False"
                AutoComplete="True"
                IncrementalFiltering="True"
                ImmediatePopup="True"
                IsPopupAutoWidth="False">
    <dxg:LookUpEdit.PopupContentTemplate>
        <ControlTemplate>
            <dxg:GridControl Name="PART_GridControl">
                <dxg:GridControl.Columns>
                    <dxg:GridColumn FieldName="ProductName"/>
                    <dxg:GridColumn FieldName="UnitPrice"/>
                    <dxg:GridColumn FieldName="Quantity"/>
                </dxg:GridControl.Columns>
                <dxg:GridControl.View>
                    <dxg:TableView AutoWidth="True"/>
                </dxg:GridControl.View>
            </dxg:GridControl>
        </ControlTemplate>
    </dxg:LookUpEdit.PopupContentTemplate>
</dxg:LookUpEdit>

C#

using System.Windows;

namespace HowToCreateLookUpEdit {
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
            lookUpEdit1.ItemsSource = new ProductList();
        }
    }
}

VB.NET

Imports System.Windows

Namespace HowToCreateLookUpEdit
    Partial Public Class MainWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
            lookUpEdit1.ItemsSource = New ProductList()
        End Sub
    End Class
End Namespace

Related GitHub Examples

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

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.

XAML

wpf-lookupedit-display-treelist-as-popup-content/CS/CustomTreeViewComboBox/MainWindow.xaml#L8

<dxg:LookUpEdit Name="lookUpEdit" VerticalAlignment="Top" Width="350" Margin="50,37,67,0" DisplayMember="Name">
    <dxg:LookUpEdit.PopupContentTemplate>
        <ControlTemplate>

wpf-lookupedit-filter-by-multiple-columns/CS/MainWindow.xaml#L17

SubstituteDisplayFilter="lookUpEdit_SubstituteDisplayFilter">
<dxg:LookUpEdit.PopupContentTemplate>
    <ControlTemplate>

wpf-dateedit-disable-dates-in-drop-down-calendar/CS/WpfApplication241/MainWindow.xaml#L12

<Style TargetType="dxe:DateEdit">
    <Setter Property="PopupContentTemplate">
        <Setter.Value>

wpf-data-grid-filter-column-lookupedit-based-on-value-in-another-column/CS/MainWindow.xaml#L28

            ValueMember="CityId" DisplayMember="CityName">
<dxg:LookUpEdit.PopupContentTemplate>
    <ControlTemplate>

wpf-autosuggestedit-use-grid-with-infiniteasyncsource-as-drop-down/CS/MainWindow.xaml#L23

                 TextMember="Subject">
<dxe:AutoSuggestEdit.PopupContentTemplate>
    <ControlTemplate>