Class RadApplicationMenu

Represents an application drop down menu control that provides an Office 2007-style application menu interface. Built on top of RadDropDownButton, it inherits comprehensive theming support, accessibility features, and integration with the Telerik WinControls framework while providing specialized behavior for application menu scenarios.

Inheritance
System.Object
RadControl
RadDropDownButton
RadApplicationMenu
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Menus & Toolbars")]
[RadToolboxItem(true)]
public class RadApplicationMenu : RadDropDownButton, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider

Constructors

RadApplicationMenu()

Initializes a new instance of the RadApplicationMenu class with default settings optimized for application menu usage.

Declaration
public RadApplicationMenu()

Properties

ButtonItems

Gets a collection representing the button items displayed in the bottom area of the application menu dropdown.

Declaration
[RadEditItemsAction]
public RadItemOwnerCollection ButtonItems { get; }
Property Value
RadItemOwnerCollection

A RadItemOwnerCollection containing the button items displayed in the footer area of the dropdown menu.
Remarks

The button items area is typically used for application-level actions such as "Options", "Exit", "About", or other global commands. These buttons appear at the bottom of the dropdown menu and provide quick access to important application functions. Common examples include settings dialogs and application closure commands.

DefaultSize

Gets the default size for the RadApplicationMenu control, optimized for typical application menu button dimensions.

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

A System.Drawing.Size structure with width and height of 48 pixels, matching standard Office-style application button dimensions.
Overrides
Remarks

The default size of 48x48 pixels provides adequate space for displaying application icons while maintaining consistency with Microsoft Office application menu design patterns.

DisplayStyle

Gets or sets the display style that determines how the application menu button appears.

Declaration
public override DisplayStyle DisplayStyle { get; set; }
Property Value
DisplayStyle

A DisplayStyle value that controls the visual presentation. The default is Image.
Overrides
Remarks

For application menus, the typical display style is Image-only to show just the application icon without text, similar to the Microsoft Office application button. Other display styles can be used for different visual presentations based on application requirements.

RightColumnItems

Gets a collection representing the items displayed in the right column of the application menu dropdown.

Declaration
[RadEditItemsAction]
public RadItemOwnerCollection RightColumnItems { get; }
Property Value
RadItemOwnerCollection

A RadItemOwnerCollection containing the items displayed in the right column area of the dropdown menu.
Remarks

The right column is typically used for displaying recently used files, recent documents, or other contextual content related to the application. This collection is only relevant when ShowTwoColumnDropDownMenu is set to true. Items added to this collection will appear in the right portion of the dropdown layout.

RightColumnWidth

Gets or sets the width of the right column in the two-column dropdown layout.

Declaration
public int RightColumnWidth { get; set; }
Property Value
System.Int32

An integer value representing the width of the right column in pixels. The default value is 300.
Remarks

This property controls the width allocation for the right column when ShowTwoColumnDropDownMenu is enabled. A larger width provides more space for right column content such as recent files lists or preview information, while a smaller width leaves more space for the main menu items in the left column.

ShowItemToolTips

Gets or sets a value indicating whether item tooltips are displayed for menu items within the application menu dropdown.

Declaration
public override bool ShowItemToolTips { get; set; }
Property Value
System.Boolean

true if tooltips should be shown for menu items; false otherwise.
Overrides
Remarks

This property controls the display of tooltips for all items within the application menu's dropdown, including main menu items, right column items, and button items. Tooltips provide additional context or help information when users hover over menu items, enhancing the user experience and accessibility.

ShowTwoColumnDropDownMenu

Gets or sets a value indicating whether the application menu displays a two-column dropdown layout.

Declaration
public bool ShowTwoColumnDropDownMenu { get; set; }
Property Value
System.Boolean

true if the dropdown menu should display in two-column mode; false for single-column mode. The default is true.
Remarks

When set to true, the dropdown menu displays with the classic application menu layout featuring a left column for main menu items and a right column for additional content. When set to false, only the main menu area is displayed, providing a simpler single-column layout similar to a standard dropdown menu. This property affects the visibility and layout of the RightColumnItems collection.

Methods

CreateButtonElement()

Creates and returns a specialized application menu button element that provides the core functionality for the application menu.

Declaration
protected override RadDropDownButtonElement CreateButtonElement()
Returns
RadDropDownButtonElement

A new RadApplicationMenuButtonElement instance that handles the application menu-specific behavior and layout.
Overrides

SetBackColorThemeOverrides()

Provides specialized background color theme override behavior for the application menu.

Declaration
protected override void SetBackColorThemeOverrides()
Overrides
Remarks

This method is intentionally empty to prevent automatic background color theme overrides that might interfere with the application menu's specialized theming requirements. The application menu uses its own theming mechanism to ensure proper visual integration with Office-style application interfaces.

SetForeColorThemeOverrides()

Provides specialized foreground color theme override behavior for the application menu.

Declaration
protected override void SetForeColorThemeOverrides()
Overrides
Remarks

This method is intentionally empty to prevent automatic foreground color theme overrides that might interfere with the application menu's specialized theming requirements. The application menu uses its own theming mechanism to ensure proper visual integration with Office-style application interfaces.

Extension Methods