BarSplitButtonItem.PopupControl Property

Gets or sets a drop-down control for the BarSplitButtonItem.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Core, DevExpress.Wpf.Core

Declaration

C#

public IPopupControl PopupControl { get; set; }

VB.NET

Public Property PopupControl As IPopupControl

Property Value

Type	Description
DevExpress.Xpf.Bars.IPopupControl	An IPopupControl object that represents a control displayed in the drop-down window.

Remarks

You can set the PopupControl property to any of these objects:

• PopupMenu - A regular popup menu.
• PopupControlContainer - A panel that can contain any controls.

Example

This example creates a BarSplitButtonItem (a button with drop-down). Click the button’s Down Arrow to display a popup window. To add a custom popup content, use the PopupControlContainer as the PopupControl. To add other bar items, use the PopupMenu.

In XAML

Window1.xaml

 <dxb:BarContainerControl>
    <dxb:ToolBarControl UseWholeRow="True">
        <dxb:BarSplitButtonItem Name="btnFontColor" Content="FontColor"  ItemClick="btnFontColor_ItemClick"
                                ArrowAlignment="Bottom" Glyph="{dx:DXImage Image=ChangeFontStyle_16x16.png}">
            <dxb:BarSplitButtonItem.PopupControl>
                <dxb:PopupControlContainer>
                    <UserControl>
                        <dxe:ColorChooser/>
                    </UserControl>
                </dxb:PopupControlContainer>
            </dxb:BarSplitButtonItem.PopupControl>
        </dxb:BarSplitButtonItem>
    </dxb:ToolBarControl>
</dxb:BarContainerControl>

In Code-Behind

Window1.xaml.cs

private void btnFontColor_ItemClick(object sender, DevExpress.Xpf.Bars.ItemClickEventArgs e) {
    PopupControlContainer pcc = (e.Item as DevExpress.Xpf.Bars.BarSplitButtonItem).PopupControl as PopupControlContainer;
    Color color = ((pcc.Content as UserControl).Content as ColorChooser).Color;
    MessageBox.Show("Color is applied: " + color.ToString());
}

View Example

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PopupControl 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

dxrichedit-for-wpf-how-to-share-toolbar-between-multiple-richeditcontrols/CS/MainWindow.xaml#L97

<dxre:BarSplitButtonColorEditItem Command="{Binding Path=FormatFontBackColor, Mode=OneTime, Source={StaticResource commands}}" CommandParameter="{Binding ElementName=richEditControlProvider1}" Name="biFormatFontBackColor">
    <dxre:BarSplitButtonColorEditItem.PopupControl>
        <dxb:PopupControlContainerInfo>

dxrichedit-for-wpf-table-api-how-to-create-a-multiplication-table-in-code-e3296/CS/MainWindow.xaml#L106

<dxre:BarSplitButtonColorEditItem Command="{Binding Path=FormatFontBackColor, Mode=OneTime, Source={StaticResource commands}}" Name="biFormatFontBackColor">
    <dxre:BarSplitButtonColorEditItem.PopupControl>
        <dxb:PopupControlContainerInfo>

Reporting_wpf-end-user-report-designer-how-to-customize-the-ribbon-toolbar-t281615/CS/ReportDesignerClassicViewTemplate.xaml#L79

<dxb:BarSplitButtonItem Glyph="{dx:DXImage Image=ChangeFontStyle_16x16.png}" ActAsDropDown="True">
    <dxb:BarSplitButtonItem.PopupControl>
        <dxb:PopupControlContainer>

how-to-set-tab-stops-so-that-each-tab-is-of-certain-characters-width-e5203/CS/TabStop_EachNCharacters/MainWindow.xaml#L84

<dxre:BarSplitButtonColorEditItem x:Name="biFormatFontBackColor" Command="{Binding FormatFontBackColor, Mode=OneTime, Source={StaticResource commands}}">
    <dxre:BarSplitButtonColorEditItem.PopupControl>
        <dxb:PopupControlContainerInfo>

dxrichedit-for-wpf-building-a-mail-application-with-the-richeditcontrol-e3276/CS/MainWindow.xaml#L114

<dxre:BarSplitButtonColorEditItem Command="{Binding Path=FormatFontBackColor, Mode=OneTime, Source={StaticResource commands}}" Name="biFormatFontBackColor">
    <dxre:BarSplitButtonColorEditItem.PopupControl>
        <dxb:PopupControlContainerInfo>

C#

how-to-create-a-barsplitbuttonitem-e1567/CS/BarSplitButtonItem/Window1.xaml.cs#L29

private void btnFontColor_ItemClick(object sender, DevExpress.Xpf.Bars.ItemClickEventArgs e) {
    PopupControlContainer pcc = (e.Item as DevExpress.Xpf.Bars.BarSplitButtonItem).PopupControl as PopupControlContainer;
    Color color = ((pcc.Content as UserControl).Content as ColorChooser).Color;