PopupControlContainer Class

The control container that can be displayed as a dropdown.

Assembly: DevExpress.XtraBars.v18.1.dll

Declaration

C#
VB.NET

[ToolboxTabName("DX.18.1: Navigation & Layout")]
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "PopupControlContainer")]
public class PopupControlContainer :
    PanelControl,
    PopupControl,
    IBarObject,
    ISupportLookAndFeel,
    IDXDropDownControlEx2,
    IDXDropDownControlEx,
    IDXDropDownControl

<ToolboxTabName("DX.18.1: Navigation & Layout")>
<ToolboxBitmap(GetType(ToolboxIconsRootNS), "PopupControlContainer")>
Public Class PopupControlContainer
    Inherits PanelControl
    Implements PopupControl,
               IBarObject,
               ISupportLookAndFeel,
               IDXDropDownControlEx2,
               IDXDropDownControlEx,
               IDXDropDownControl

The following members accept/return PopupControlContainer objects:

Remarks

A PopupControlContainer object represents a panel that can contain any controls. This panel can be displayed as a dropdown for DropDownButton controls, bar buttons and the Ribbon Application Button.

PopupControlContainer_RibbonApplicationMenu

A PopupControlContainer object can be created at design time by dragging the PopupControlContainer component from the Toolbox onto a form.

Note

For the PopupControlContainer object to work correctly, it must be bound to a BarManager or RibbonControl object using the PopupControlContainer.Manager or PopupControlContainer.Ribbon property, respectively.

After the panel has been created, you can add controls to it, and then bind the panel to a specific control using the following properties:

for a DropDownButton control—use the DropDownButton.DropDownControl property;
for a bar button—use the BarButtonItem.DropDownControl property. The BarButtonItem.ButtonStyle property must be set to BarButtonStyle.DropDown and the BarButtonItem.DropDownEnabled property must be set to true, to enable the dropdown functionality;
for the Ribbon Application Button—use the RibbonControl.ApplicationButtonDropDownControl property.

Note

A PopupControlContainer is never displayed at runtime as a standalone panel. It can only be displayed as a dropdown.

The following code snippets (auto-collected from DevExpress Examples) contain references to the PopupControlContainer 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#
VB.NET

how-to-implement-a-custom-menu-for-filtercontrol-e3457/CS/CustomFilterControlPopupMenu/CustomMenuManager.cs#L17


PopupControlContainer fPopup;
PopupControlContainer Popup {

how-to-create-popupcontrolcontainer-that-uses-its-own-lookandfeel-settings-e1441/CS/Q205284/MyPopupControlContainer.cs#L9

namespace DXSample {
    public class MyPopupControlContainer : PopupControlContainer {
        public MyPopupControlContainer() : base() { }

popupcontrolcontainer-how-to-draw-a-custom-string-in-popup-control-containers-footer-t265126/CS/WindowsFormsApplication37/Form1.cs#L21

void popupControlContainer1_Popup(object sender, EventArgs e) {
    PopupControlContainer control = sender as PopupControlContainer;
    PopupContainerBarControl barControl = (control.Parent as PopupContainerBarControl);

how-to-create-popupcontrolcontainer-that-uses-its-own-lookandfeel-settings-e1441/VB/Q205284/MyPopupControlContainer.vb#L11

Public Class MyPopupControlContainer
    Inherits PopupControlContainer
    Public Sub New()

popupcontrolcontainer-how-to-draw-a-custom-string-in-popup-control-containers-footer-t265126/VB/WindowsFormsApplication37/Form1.vb#L23

Private Sub popupControlContainer1_Popup(ByVal sender As Object, ByVal e As EventArgs)
    Dim control As PopupControlContainer = TryCast(sender, PopupControlContainer)
    Dim barControl As PopupContainerBarControl = (TryCast(control.Parent, PopupContainerBarControl))