Class

RadMenuItem

Initializes a new instance of the RadMenuItem class without menu text or a value.

Declaration

public RadMenuItem()

Identifies the Checked routed event.

Declaration

[SuppressMessage("Microsoft.Security", "CA2104:DoNotDeclareReadOnlyMutableReferenceTypes")]
public static readonly RoutedEvent CheckedEvent

Field Value

Identifies the CheckedIcon dependency property.

Declaration

public static readonly DependencyProperty CheckedIconProperty

Field Value

Identifies the CheckedIconTemplate dependency property.

Declaration

public static readonly DependencyProperty CheckedIconTemplateProperty

Field Value

Identifies the Click routed event.

Declaration

[SuppressMessage("Microsoft.Security", "CA2104:DoNotDeclareReadOnlyMutableReferenceTypes")]
public static readonly RoutedEvent ClickEvent

Field Value

Identifies the CommandParameter dependency property.

Declaration

public static readonly DependencyProperty CommandParameterProperty

Field Value

Identifies the Command dependency property.

Declaration

public static readonly DependencyProperty CommandProperty

Field Value

Identifies the CommandTarget property.

Declaration

public static readonly DependencyProperty CommandTargetProperty

Field Value

Identifies the DropDownHeight dependency property.

Declaration

public static readonly DependencyProperty DropDownHeightProperty

Field Value

Identifies the DropDownPlacement dependency property.

Declaration

public static readonly DependencyProperty DropDownPlacementProperty

Field Value

Identifies the DropDownWidth dependency property.

Declaration

public static readonly DependencyProperty DropDownWidthProperty

Field Value

Identifies the IconColumnWidth dependency property.

Declaration

public static readonly DependencyProperty IconColumnWidthProperty

Field Value

Identifies the Icon dependency property.

Declaration

public static readonly DependencyProperty IconProperty

Field Value

Identifies the IconTemplate dependency property.

Declaration

public static readonly DependencyProperty IconTemplateProperty

Field Value

Identifies the InputGestureText dependency property.

Declaration

public static readonly DependencyProperty InputGestureTextProperty

Field Value

Identifies the IsCheckable dependency property.

Declaration

public static readonly DependencyProperty IsCheckableProperty

Field Value

Identifies the IsChecked dependency property.

Declaration

public static readonly DependencyProperty IsCheckedProperty

Field Value

Identifies the IsCurrent dependency property.

Declaration

public static readonly DependencyProperty IsCurrentProperty

Field Value

Identifies the IsHighlighted dependency property.

Declaration

public static readonly DependencyProperty IsHighlightedProperty

Field Value

Identifies the IsSeparatorProperty dependency property.

Declaration

public static readonly DependencyProperty IsSeparatorProperty

Field Value

Identifies the IsSubmenuOpen dependency property.

Declaration

public static readonly DependencyProperty IsSubmenuOpenProperty

Field Value

Identifies the IsSuspendingPopupAnimation readonly dependency property.

Declaration

public static readonly DependencyProperty IsSuspendingPopupAnimationProperty

Field Value

Identifies the ItemContainerTemplateSelector dependency property.

Declaration

public static readonly DependencyProperty ItemContainerTemplateSelectorProperty

Field Value

Identifies the ItemIconPosition dependency property.

Declaration

public static readonly DependencyProperty ItemIconPositionProperty

Field Value

Identifies the Menu readonly dependency property.

Declaration

public static readonly DependencyProperty MenuProperty

Field Value

Identifies the Role dependency property.

Declaration

public static readonly DependencyProperty RoleProperty

Field Value

Identifies the SeparatorTemplateKey dependency property.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use RadMenuSeparatorItem container and set its Template property.", false)]
public static readonly DependencyProperty SeparatorTemplateKeyProperty

Field Value

Identifies the StaysOpenOnClick dependency property.

Declaration

public static readonly DependencyProperty StaysOpenOnClickProperty

Field Value

Identifies the SubmenuClosed routed event.

Declaration

[SuppressMessage("Microsoft.Security", "CA2104:DoNotDeclareReadOnlyMutableReferenceTypes")]
public static readonly RoutedEvent SubmenuClosedEvent

Field Value

Identifies the SubmenuHeaderTemplateKey dependency property.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use Template property.", false)]
public static readonly DependencyProperty SubmenuHeaderTemplateKeyProperty

Field Value

Identifies the SubmenuItemTemplateKey dependency property.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use Template property.", false)]
public static readonly DependencyProperty SubmenuItemTemplateKeyProperty

Field Value

Identifies the SubmenuOpened routed event.

Declaration

[SuppressMessage("Microsoft.Security", "CA2104:DoNotDeclareReadOnlyMutableReferenceTypes")]
public static readonly RoutedEvent SubmenuOpenedEvent

Field Value

Identifies the TopLevelHeaderTemplateKey dependency property.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use RadMenuRootItem container and set its Template property.", false)]
public static readonly DependencyProperty TopLevelHeaderTemplateKeyProperty

Field Value

Identifies the TopLevelItemTemplateKey dependency property.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use RadMenuRootItem container and set its Template property.", false)]
public static readonly DependencyProperty TopLevelItemTemplateKeyProperty

Field Value

Identifies the Unchecked routed event.

Declaration

[SuppressMessage("Microsoft.Security", "CA2104:DoNotDeclareReadOnlyMutableReferenceTypes")]
public static readonly RoutedEvent UncheckedEvent

Field Value

Gets or sets the icon that appears in a RadMenuItem when it is checkable and is checked. This is a dependency property.

Declaration

public object CheckedIcon { get; set; }

Property Value

Gets or sets the data template used for the CheckedIcon. This is a dependency property.

Declaration

public DataTemplate CheckedIconTemplate { get; set; }

Property Value

Gets the command that will be executed when the command source is invoked.

Declaration

[TypeConverter(typeof(CommandConverter))]
public ICommand Command { get; set; }

Property Value

Represents a user defined data value that can be passed to the command when it is executed.

Declaration

public object CommandParameter { get; set; }

Property Value

The object that the command is being executed on.

Declaration

public IInputElement CommandTarget { get; set; }

Property Value

Gets or sets the height of the drop-down area.

Declaration

public double DropDownHeight { get; set; }

Property Value

Gets or sets the placement of the drop-down area.

Declaration

public MenuPlacementMode DropDownPlacement { get; set; }

Property Value

Gets or sets the width of the drop-down area.

Declaration

public double DropDownWidth { get; set; }

Property Value

Gets whether the control supports scrolling.

Declaration

protected override bool HandlesScrolling { get; }

Property Value

Gets or sets the icon that appears in a RadMenuItem. This is a dependency property.

Declaration

[SRCategory("Appearance")]
public object Icon { get; set; }

Property Value

Gets or sets the width of the column that contains the icon.

Declaration

public double IconColumnWidth { get; set; }

Property Value

Gets or sets the data template used for Icon. This is a dependency property.

Declaration

public DataTemplate IconTemplate { get; set; }

Property Value

Gets or sets the text describing an input gesture that will call the command tied to the specified item. This property does not associate the input gesture with the menu item. It simply adds text to the menu item. The application must handle the user's input to carry out the action.

Declaration

[Bindable(true)]
public string InputGestureText { get; set; }

Property Value

Gets a value that indicates whether a RadMenuItem can be checked. This is a dependency property.

Declaration

[SRCategory("Behavior")]
public bool IsCheckable { get; set; }

Property Value

Gets or sets a value that indicates whether the RadMenuItem is checked. This is a dependency property.

Declaration

[SRCategory("Appearance")]
public bool IsChecked { get; set; }

Property Value

Gets or sets whether the item is current item.

Declaration

public bool IsCurrent { get; set; }

Property Value

True if the RadMenuItem can be selected; otherwise, false.

Declaration

protected override bool IsEnabledCore { get; }

Property Value

Gets a value that indicates whether a RadMenuItem is highlighted. This is a dependency property.

Declaration

[Browsable(false)]
[SRCategory("Appearance")]
public bool IsHighlighted { get; protected set; }

Property Value

Gets or sets a value indicating whether this instance is a separator.

Declaration

public bool IsSeparator { get; set; }

Property Value

Gets a value that indicates whether the submenu of the RadMenuItem is open. This is a dependency property.

Declaration

[Browsable(false)]
[SRCategory("Appearance")]
public bool IsSubmenuOpen { get; set; }

Property Value

Gets whether a menu suspends animations on its Popup control.

Declaration

public bool IsSuspendingPopupAnimation { get; }

Property Value

Gets or sets the custom logic for choosing a template used to display each item.

Declaration

public DataTemplateSelector ItemContainerTemplateSelector { get; set; }

Property Value

Gets or sets the icon position for the icon. This is a dependency property.

Declaration

public ItemIconPosition ItemIconPosition { get; set; }

Property Value

Gets the RadMenu for this RadMenuItem. This is a readonly dependency property.

Declaration

public MenuBase Menu { get; }

Property Value

Gets a value that indicates the role of a RadMenuItem. This is a dependency property.

Declaration

[SRCategory("Behavior")]
public MenuItemRole Role { get; }

Property Value

Gets the resource key for a style applied to a RadMenuItem when the RadMenuItem is a separator.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use RadMenuSeparatorItem container and set its Template property.", false)]
public ControlTemplate SeparatorTemplateKey { get; set; }

Property Value

Gets or sets a value that indicates that the submenu in which this RadMenuItem is located should not close when this item is clicked. This is a dependency property.

Declaration

[SRCategory("Behavior")]
public bool StaysOpenOnClick { get; set; }

Property Value

Gets the resource key for a style applied to a RadMenuItem when the RadMenuItem is a header of a submenu.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use Template property.", false)]
public ControlTemplate SubmenuHeaderTemplateKey { get; set; }

Property Value

Gets the resource key for a style applied to a RadMenuItem when the RadMenuItem is a submenu.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use Template property.", false)]
public ControlTemplate SubmenuItemTemplateKey { get; set; }

Property Value

Gets the resource key for a style applied to a RadMenuItem when the RadMenuItem is a header of a top-level menu.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use RadMenuRootItem container and set its Template property.", false)]
public ControlTemplate TopLevelHeaderTemplateKey { get; set; }

Property Value

Gets the resource key for a style applied to a RadMenuItem when it is a top-level RadMenuItem.

Declaration

[Obsolete("Since 2013 Q1 this property is not needed. Please use RadMenuRootItem container and set its Template property.", false)]
public ControlTemplate TopLevelItemTemplateKey { get; set; }

Property Value

Updates the visual state of the control.

Declaration

protected virtual void ChangeVisualState(bool useTransitions)

Parameters

Clear the Menu property.

Declaration

protected override void ClearContainerForItemOverride(DependencyObject element, object item)

Parameters

Creates or identifies the element that is used to display the given item.

Declaration

protected override DependencyObject GetContainerForItemOverride()

Returns

Determines if the specified item is RadMenuItem.

Declaration

protected override sealed bool IsItemItsOwnContainerOverride(object item)

Parameters

Returns

Determines if the specified item is RadMenuItem.

Declaration

protected virtual bool IsItemItsOwnContainerProtected(object item)

Parameters

Returns

Provides class handling for when an access key that is meaningful for this element is invoked.

Declaration

protected override void OnAccessKey(AccessKeyEventArgs e)

Parameters

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call .

Declaration

public override void OnApplyTemplate()

Called when the IsChecked property becomes true.

Declaration

protected virtual void OnChecked(RoutedEventArgs e)

Parameters

Called when a RadMenuItem is clicked and raises a Click event.

Declaration

protected virtual void OnClick()

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

Declaration

protected override AutomationPeer OnCreateAutomationPeer()

Returns

Invoked when an unhandled Keyboard.GotKeyboardFocus attached event reaches an element in its route that is derived from this class.

Declaration

protected override void OnGotKeyboardFocus(KeyboardFocusChangedEventArgs e)

Parameters

Declaration

protected override void OnHeaderChanged(object oldHeader, object newHeader)

Parameters

Declaration

protected override void OnHeaderTemplateChanged(DataTemplate oldHeaderTemplate, DataTemplate newHeaderTemplate)

Parameters

Declaration

protected override void OnHeaderTemplateSelectorChanged(DataTemplateSelector oldHeaderTemplateSelector, DataTemplateSelector newHeaderTemplateSelector)

Parameters

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

Declaration

protected override void OnInitialized(EventArgs e)

Parameters

Called when the focus is no longer on or within a RadMenuItem.

Declaration

protected override void OnIsKeyboardFocusWithinChanged(DependencyPropertyChangedEventArgs e)

Parameters

Invoked when the property changes.

Declaration

protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)

Parameters

Raises the event.

Declaration

protected override void OnKeyDown(KeyEventArgs e)

Parameters

Raises the event.

Declaration

protected override void OnMouseEnter(MouseEventArgs e)

Parameters

Raises the event.

Declaration

protected override void OnMouseLeave(MouseEventArgs e)

Parameters

Raises the event.

Declaration

protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)

Parameters

Raises the event.

Declaration

protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)

Parameters

Raises the event.

Declaration

protected override void OnMouseMove(MouseEventArgs e)

Parameters

Handles MouseRightButtonDown event.

Declaration

protected override void OnMouseRightButtonDown(MouseButtonEventArgs e)

Parameters

Handles MouseRightButtonUp event.

Declaration

protected override void OnMouseRightButtonUp(MouseButtonEventArgs e)

Parameters

Called when the submenu of a RadMenuItem is closed.

Declaration

protected virtual void OnSubmenuClosed(RadRoutedEventArgs e)

Parameters

Called when the submenu of a RadMenuItem is opened.

Declaration

protected virtual void OnSubmenuOpened(RadRoutedEventArgs e)

Parameters

Called when the IsChecked property becomes false.

Declaration

protected virtual void OnUnchecked(RoutedEventArgs e)

Parameters

Prepares the specified element to display the specified item.

Declaration

protected override void PrepareContainerForItemOverride(DependencyObject element, object item)

Parameters

Resets the theme.

Declaration

public void ResetTheme()

Occurs when a RadMenuItem is checked.

Declaration

[SRCategory("Behavior")]
public event RoutedEventHandler Checked

Event Value

Occurs when a RadMenuItem is clicked.

Declaration

[SRCategory("Behavior")]
public event RadRoutedEventHandler Click

Event Value

Occurs when the state of the IsSubmenuOpen property changes to false.

Declaration

[SRCategory("Behavior")]
public event RadRoutedEventHandler SubmenuClosed

Event Value

Occurs when the state of the IsSubmenuOpen property changes to true.

Declaration

[SRCategory("Behavior")]
public event RadRoutedEventHandler SubmenuOpened

Event Value

Occurs when a RadMenuItem is unchecked.

Declaration

[SRCategory("Behavior")]
public event RoutedEventHandler Unchecked

Event Value