Class RadApplicationMenuButtonElement

Represents the button element for the RadApplicationMenu, providing specialized dropdown behavior and two-column layout management.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
RadDropDownButtonElement
RadApplicationMenuButtonElement
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadApplicationMenuButtonElement : RadDropDownButtonElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IDropDownMenuOwner, ISiteProvider, IItemsOwner, IImageElement
Remarks

RadApplicationMenuButtonElement extends RadDropDownButtonElement to provide the core functionality for Office 2007-style application menus. It manages the specialized dropdown menu layout with support for two-column display modes, hierarchical menu item organization, and proper popup positioning.

Constructors

RadApplicationMenuButtonElement()

Declaration
public RadApplicationMenuButtonElement()

Properties

ShowTwoColumnDropDownMenu

Gets or sets a value indicating whether RadApplicationMenu displays a TwoColumnDropDownMenu.

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.

Methods

CreateDropDown()

Creates and configures the specialized dropdown popup for the application menu.

Declaration
protected override RadDropDownButtonPopup CreateDropDown()
Returns
RadDropDownButtonPopup

A configured RadApplicationMenuDropDown instance that provides the application menu's dropdown functionality.
Overrides

DisposeManagedResources()

Performs cleanup of managed resources, properly disposing of event subscriptions and dropdown menu resources.

Declaration
protected override void DisposeManagedResources()
Overrides

InitializeFields()

Initializes the field values for this element, setting up default property states.

Declaration
protected override void InitializeFields()
Overrides
Remarks

This method sets the default value for the ShowTwoColumnDropDownMenu property to true, enabling the two-column layout by default to match typical Office 2007-style application menu behavior.

OnBitStateChanged(Int64, Boolean, Boolean)

Handles bit state changes and applies appropriate visual updates for the ShowTwoColumnDropDownMenu property.

Declaration
protected override void OnBitStateChanged(long key, bool oldValue, bool newValue)
Parameters
System.Int64 key

The bit state key that changed.
System.Boolean oldValue

The previous value of the bit state.
System.Boolean newValue

The new value of the bit state.
Overrides

OnDropDownOpening(CancelEventArgs)

Handles the dropdown opening event and configures design-time positioning properties for proper visual designer support.

Declaration
protected override void OnDropDownOpening(CancelEventArgs e)
Parameters
System.ComponentModel.CancelEventArgs e

The event arguments that can be used to cancel the dropdown opening operation.
Overrides

OnPropertyChanged(RadPropertyChangedEventArgs)

Handles property change notifications and applies special handling for right-to-left layout changes.

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

The property change event arguments containing information about the changed property.
Overrides

Extension Methods