Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.v24.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:

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