Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Collapse]Ribbon, Bars and Menu
   [Expand]Bars
   [Collapse]Ribbon
    [Expand]The Ribbon UI
    [Collapse]Visual Elements
      Ribbon Page
      Ribbon Page Group
      Categories and Contextual Tabs
      Quick Access Toolbar
      Page Header Items
      Application Button
    [Expand]Items and Item Links
     Ribbon Styles
    [Expand]Galleries
    [Expand]Main Menus
    [Expand]Ribbon Control Designer
    [Expand]Runtime Capabilities
    [Expand]Miscellaneous
     Known Issues
   [Expand]Popup Menus
    Radial Menu
   [Expand]Common Features
   [Expand]Examples
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Application Button

The Application button allows an end-user to access an application's main menu. The main menu typically contains commands such as New, Open, Print and Exit. However, you can place any required commands in the main menu.

The Application button is displayed in the top left corner of the Ribbon control. It is painted differently in different Ribbon paint styles (see the RibbonControl.RibbonStyle property).

Ribbon Style Image Notes
Office 2007

1. In this style, the Application button is only displayed when the RibbonControl resides in a Ribbon Form.

2. Text is not displayed in this style. The button can only display an image specified by the RibbonControl.ApplicationIcon property.

Office 2010, Office 2013 and MacOffice

1. In these styles, the Application button is supported for any form.

2. The button can display text (RibbonControl.ApplicationButtonText) or an image (RibbonControl.ApplicationIcon). If an image is assigned, no text is displayed.

To specify the Application button's visibility, use the RibbonControl.ShowApplicationButton property.

The RibbonControl.ApplicationButtonDropDownControl property specifies the menu displayed when the Application Button is clicked. There are two types of menus.

Expanded Application Button Events

A click on the Application button fires the RibbonControl.ApplicationButtonClick event. You can handle this event or the RibbonControl.BeforeApplicationButtonContentControlShow event to customize the control assigned to the RibbonControl.ApplicationButtonDropDownControl property. It is possible to use the RibbonControl.ApplicationButtonClick event to dynamically assign the required control to the RibbonControl.ApplicationButtonDropDownControl property.

To perform actions when the dropdown control associated with the Application button is hidden, handle the RibbonControl.AfterApplicationButtonContentControlHidden event.

You can allow an end-user to access the Application button via the keyboard by assigning a keyboard shortcut to the button via the RibbonControl.ApplicationButtonKeyTip property.

How would you rate this topic?​​​​​​​