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.v20.1.dll

Declaration

[DefaultValue(null)]
[DXCategory("Behavior")]
public virtual object ApplicationButtonDropDownControl { get; set; }
<DefaultValue(Nothing)>
<DXCategory("Behavior")>
Public Overridable Property ApplicationButtonDropDownControl As Object

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:

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.

See Also