Class
RadMenu

Represents a menu control that allows for hierarchical organization of items, providing a dynamic user interface for navigating through a set of options. The RadMenu class includes support for main menu activation, orientation configuration, delay settings for showing and hiding menu items, and keyboard navigation. It is designed to facilitate the creation of interactive menus in a WPF application, allowing for comprehensive control over the visual representation and behavior of menu items.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:

cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadMenu : MenuBase

Inheritance: objectMenuBaseRadMenu

Inherited Members MenuBase.ItemContainerTemplateSelectorPropertyMenuBase.IconColumnWidthPropertyMenuBase.ClickToOpenPropertyMenuBase.ShowDelayPropertyMenuBase.HideDelayPropertyMenuBase.NotifyOnHeaderClickPropertyMenuBase.OnIsKeyboardFocusWithinChanged(DependencyPropertyChangedEventArgs)MenuBase.GetContainerForItemOverride()MenuBase.IsItemItsOwnContainerOverride(object)MenuBase.IsItemItsOwnContainerProtected(object)MenuBase.ClearContainerForItemOverride(DependencyObject, object)MenuBase.OnItemClick(RadRoutedEventArgs)MenuBase.OnLoaded(RoutedEventArgs)MenuBase.NotifyOnHeaderClickMenuBase.ClickToOpenMenuBase.IconColumnWidthMenuBase.ShowDelayMenuBase.HideDelayMenuBase.ItemContainerTemplateSelectorMenuBase.ItemClick

Constructors

RadMenu()

Initializes a new instance of the RadMenu class.

Declaration

cs-api-definition
public RadMenu()

Fields

IsMainMenuProperty

Identifies the IsMainMenu dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsMainMenuProperty

Field Value

DependencyProperty

OrientationProperty

Identifies the Orientation dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty OrientationProperty

Field Value

DependencyProperty

TopLevelHideDelayProperty

Identifies the TopLevelHideDelay dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TopLevelHideDelayProperty

Field Value

DependencyProperty

TopLevelShowDelayProperty

Identifies the TopLevelShowDelay dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TopLevelShowDelayProperty

Field Value

DependencyProperty

WaitForTopLevelHeaderHideDurationProperty

Identifies the WaitForTopLevelHeaderHideDuration dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty WaitForTopLevelHeaderHideDurationProperty

Field Value

DependencyProperty

Properties

IsMainMenu

Gets or sets a value that specifies whether this RadMenu will participate in main menu activation notification. The default value is False. This is a dependency property.

Declaration

cs-api-definition
public bool IsMainMenu { get; set; }

Property Value

bool

Orientation

Gets or sets a value that specifies the dimension in which child content is arranged. This is a dependency property.

Declaration

cs-api-definition
public Orientation Orientation { get; set; }

Property Value

Orientation

TopLevelHideDelay

Gets or sets the time, in milliseconds, before closing menu when the mouse cursor leave a root menu item.

Declaration

cs-api-definition
[TypeConverter(typeof(DurationConverter))]
public Duration TopLevelHideDelay { get; set; }

Property Value

Duration

TopLevelShowDelay

Gets or sets the time, in milliseconds, before displaying menu when the mouse cursor is over a root menu item.

Declaration

cs-api-definition
[TypeConverter(typeof(DurationConverter))]
public Duration TopLevelShowDelay { get; set; }

Property Value

Duration

WaitForTopLevelHeaderHideDuration

Gets or sets whether RadMenu will wait for TopLevelHideDelay to complete or not. If set to True root menu item will stay open until TopLevelHideDelay is completed.

Declaration

cs-api-definition
public bool WaitForTopLevelHeaderHideDuration { get; set; }

Property Value

bool

True if RadMenu waits until TopLevelHideDelay is completed; otherwise, false.

Methods

OnCreateAutomationPeer()

Provides an appropriate RadMenuAutomationPeer implementation for this control, as part of the WPF automation infrastructure.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

The type-specific AutomationPeer implementation.

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

OnKeyDown(KeyEventArgs)

Invoked when keyboard key is pressed while the element has focus.

Declaration

cs-api-definition
protected override void OnKeyDown(KeyEventArgs e)

Parameters

e

KeyEventArgs

The KeyEventArgs that contains the event data.

Overrides MenuBase.OnKeyDown(KeyEventArgs)

PrepareContainerForItemOverride(DependencyObject, object)

Prepares the specified element to display the specified item.

Declaration

cs-api-definition
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)

Parameters

element

DependencyObject

Element used to display the specified item.

item

object

Specified item.

Overrides MenuBase.PrepareContainerForItemOverride(DependencyObject, object)

Events

PropertyChanged

Occurs when a property value changes.

Declaration

cs-api-definition
public event PropertyChangedEventHandler PropertyChanged

Event Value

PropertyChangedEventHandler