ClassRadApplicationMenu
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.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Menus & Toolbars")]
[DefaultBindingProperty("Items")]
[RadToolboxItem(true)]
[ToolboxBitmap(typeof(RadContextMenu), "RadApplicationMenu.bmp")]
public class RadApplicationMenu : RadDropDownButton, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProviderInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadDropDownButtonRadApplicationMenu
Implements:
Inherited Members
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]
[Browsable(true)]
public RadItemOwnerCollection ButtonItems { get; }Property Value
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
A 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
[Browsable(true)]
public override DisplayStyle DisplayStyle { get; set; }Property Value
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]
[Browsable(true)]
public RadItemOwnerCollection RightColumnItems { get; }Property Value
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
[Browsable(true)]
public int RightColumnWidth { get; set; }Property Value
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
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
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
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.