RibbonControl.ApplicationButtonDropDownControl Property
Gets or sets the drop-down control which is invoked when the Application Button is clicked.
Namespace: DevExpress.XtraBars.Ribbon
Assembly: DevExpress.XtraBars.v23.2.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(null)]
[DXCategory("Behavior")]
public virtual object ApplicationButtonDropDownControl { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| Object | null | An object (any control or specific DevExpress component) which is invoked when the Ribbon Form’s Application Button is clicked. |
Remarks
The Application Button should provide access to the main menu of an application that uses the Ribbon UI. By default, clicking this button has no effect.
The ApplicationButtonDropDownControl property allows you to specify the control that needs to be displayed when the Application Button is clicked. The property accepts 1) any Control descendant; 2) an object that implements the DevExpress.XtraBars.PopupControl interface.
The following controls implement the DevExpress.XtraBars.PopupControl interface:
- ApplicationMenu - an Application Popup Menu;
- PopupControlContainer - a controls container;
- PopupMenu - a menu;
- GalleryDropDown - a control which encapsulates a gallery.
- BackstageViewControl - allows you to emulate a menu found in Microsoft Office 2010 applications.
To dynamically customize the drop-down control before it’s displayed onscreen, use the RibbonControl.BeforeApplicationButtonContentControlShow or RibbonControl.ApplicationButtonClick event.
If a Control descendant is assigned to the ApplicationButtonDropDownControl property, the Control’s size is changed so that it covers the entire RibbonForm. If a DevExpress.XtraBars.PopupControl object is assigned to the ApplicationButtonDropDownControl property, its size is not affected.
The RibbonControl.HideApplicationButtonContentControl method allows you to close the control assigned to the ApplicationButtonDropDownControl property.