Application Button

  • 2 minutes to read

End-users can use the Application button in the Ribbon Control's top left corner to access an application's main menu. The Ribbon style (see the RibbonControl.RibbonStyle property) determines the button’s appearance and behavior. You can test all available styles in the "Ribbon Simple Pad" demo module available in the DevExpress Demo Center.

Ribbon - AppButton - All Offices

The table below lists the properties and events related to the Application Button.

API

Description

RibbonControl.ApplicationButtonDropDownControl

Gets or sets the drop-down control which is invoked when the Application Button is clicked.

This property accepts the following class instances as a value:

RibbonControl.ShowApplicationButton

Gets or sets whether the Application Button is visible.

  • In Office 2007 style, the Application Button requires the Ribbon Form. Otherwise, the Button cannot be displayed.
  • In Mac Office style, the Button is hidden. You should enable this setting to show the Application Button.

RibbonControl.ApplicationButtonImageOptions

Provides access to options that allow you to specify and customize the Application Button's raster or vector icon.

  • If you assign both a raster and vector icons, the Application Button shows the vector icon.
  • You can use the SvgImageSize setting to resize a vector icon.
  • The Tablet Office style does not support custom images. The Application Button applies the current skin's icon.

RibbonControl.ApplicationButtonText

Gets or sets the Application Button's text.

RibbonControl.ApplicationButtonClick

Occurs when the Application Button is clicked.

RibbonControl.BeforeApplicationButtonContentControlShow

RibbonControl.AfterApplicationButtonContentControlHidden

These events allow you to perform custom actions before/after a main application menu opens/closes.

RibbonControl.ColorScheme

Applies a color to the Application Button and other Ribbon elements.

Button appearance (no API)

Ribbon uses Skin images and settings to paint an Application Button, there is no API to modify the button appearance. Run the Skin Editor and create a Skin with custom ApplicationButton2010 skin element settings.