Application Button

Jan 20, 2025
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.

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 preferred icon size is 16x16.
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.

The Office 2007 and Tablet Office styles do not display the Application Button’s text.
The Button shows only text if the Application Button has text and an icon (the RibbonControl.ApplicationButtonImageOptions property).
You cannot use HTML Text Formatting to format the button..

| |

RibbonControl.ApplicationButtonClick

Occurs when the Application Button is clicked.

| |

ShowApplicationButtonContentControl
HideApplicationButtonContentControl

Use these methods to display or hide the main application menu.

| |

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.