Class RadMenuItem

Represents a selectable option displayed on a RadMenuElement or in a drop down panel.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
RadButtonItem
RadMenuItemBase
RadMenuItem
AssociatedMenuItem
FilterMenuItem
FilterViewMenuItem
GanttViewMenuItem
RadPageViewMenuItem
PivotFilterMenuTreeItem
PropertyGridMenuItem
RadFilterComposeMenuItem
RadFilterOperationMenuItem
RadMenuAssociatedItem
RadToolbarFormMenuItem
SchedulerMenuItem
TreeViewMenuItem
ZoomMenuItem
SpreadsheetFilteringMenuItem
RichTextEditorContextMenuItem
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

[ComVisible(false)]
[RadNewItem("Add New Item", true)]
public class RadMenuItem : RadMenuItemBase, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IButtonControl, IImageElement, IHierarchicalItem, IItemsOwner, ISiteProvider

Constructors

RadMenuItem()

Initializes a new instance of the RadMenuItem class.

Declaration
public RadMenuItem()

RadMenuItem(String)

Initializes a new instance of the RadMenuItem class using the displayed text.

Declaration
public RadMenuItem(string text)
Parameters
System.String text

RadMenuItem(String, Object)

Initializes a new instance of the RadMenuItem class using the displayed text.

Declaration
public RadMenuItem(string text, object tag)
Parameters
System.String text

System.Object tag

Fields

ActivateMenuItemCommand

Declaration
public static readonly ActivateMenuItemCommand ActivateMenuItemCommand
Field Value
ActivateMenuItemCommand

CheckStateProperty

Declaration
public static RadProperty CheckStateProperty
Field Value
RadProperty

DescriptionFontProperty

Declaration
public static RadProperty DescriptionFontProperty
Field Value
RadProperty

DescriptionTextVisibleProperty

Declaration
public static RadProperty DescriptionTextVisibleProperty
Field Value
RadProperty

HintTextProperty

Declaration
public static RadProperty HintTextProperty
Field Value
RadProperty

ShowArrowProperty

Declaration
public static RadProperty ShowArrowProperty
Field Value
RadProperty

Properties

AccessibleName

Gets or sets the name of the control for use by accessibility client applications.

Declaration
public override string AccessibleName { get; set; }
Property Value
System.String

Overrides

BorderPrimitive

Gets the BorderPrimitive of RadMenuItem responsible for appearance of the border.

Declaration
public BorderPrimitive BorderPrimitive { get; }
Property Value
BorderPrimitive

CheckOnClick

Gets or sets a value indicating whether a menu item should toggle its CheckState on mouse click.

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

DescriptionFont

Gets or sets the font of the descrition text of the RadMenuItem.

Declaration
[RadPropertyDefaultValue("DescriptionFont", typeof(RadMenuItem))]
public virtual Font DescriptionFont { get; set; }
Property Value
System.Drawing.Font

DescriptionText

Gets or sets the description text associated with this item.

Declaration
public string DescriptionText { get; set; }
Property Value
System.String

DescriptionTextVisible

Gets the visibility of description text element

Declaration
public virtual bool DescriptionTextVisible { get; }
Property Value
System.Boolean

FillPrimitive

Gets the FillPrimitive of RadMenuItem responsible for the background appearance.

Declaration
public FillPrimitive FillPrimitive { get; }
Property Value
FillPrimitive

HintText

Gets or sets the text that appears as a HintText for a menu item.

Declaration
public string HintText { get; set; }
Property Value
System.String

ImageIndex

Gets or sets the index value of the image that is displayed on the item.

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

Overrides

ImageKey

Gets or sets the key accessor for the image in the ImageList.

Declaration
public override string ImageKey { get; set; }
Property Value
System.String

Overrides

IsChecked

Gets or sets a value indicating whether the menu item is checked.

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

Layout

Declaration
public virtual RadMenuItemLayout Layout { get; }
Property Value
RadMenuItemLayout

LeftColumnElement

Declaration
public virtual RadElement LeftColumnElement { get; }
Property Value
RadElement

MenuLayout

Declaration
public virtual RadDropDownMenuLayout MenuLayout { get; }
Property Value
RadDropDownMenuLayout

MergeIndex

Gets or sets the position of a merged item within the current menu.

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

RightColumnElement

Declaration
public virtual RadElement RightColumnElement { get; }
Property Value
RadElement

ShowArrow

Gets or sets if the arrow is shown when the menu item contains sub menu.

Declaration
[RadPropertyDefaultValue("ShowArrow", typeof(RadMenuItem))]
public bool ShowArrow { get; set; }
Property Value
System.Boolean

TextSeparatorVisibility

Gets or sets the visibility of the separator element between the text and the description text

Declaration
public virtual ElementVisibility TextSeparatorVisibility { get; set; }
Property Value
ElementVisibility

ToggleState

Gets or sets the ToggleState. Toggle state enumeration defines the following values: Off, Indeterminate, and On.

Declaration
public ToggleState ToggleState { get; set; }
Property Value
ToggleState

Methods

CanHandleShortcut(ShortcutEventArgs)

Declaration
protected override bool CanHandleShortcut(ShortcutEventArgs e)
Parameters
ShortcutEventArgs e

Returns
System.Boolean

Overrides

CoerceValue(RadPropertyValue, Object)

Declaration
protected override object CoerceValue(RadPropertyValue propVal, object baseValue)
Parameters
RadPropertyValue propVal

System.Object baseValue

Returns
System.Object

Overrides

CreateChildElements()

Declaration
protected override void CreateChildElements()
Overrides

DisposeManagedResources()

Declaration
protected override void DisposeManagedResources()
Overrides

GetArrowVisible()

Determines whether the arrow is currently displayed for this item.

Declaration
public bool GetArrowVisible()
Returns
System.Boolean

InitializeFields()

Declaration
protected override void InitializeFields()
Overrides

ItemsChanged(RadItemCollection, RadItem, ItemsChangeOperation)

Declaration
protected virtual void ItemsChanged(RadItemCollection changed, RadItem target, ItemsChangeOperation operation)
Parameters
RadItemCollection changed

RadItem target

ItemsChangeOperation operation

OnBitStateChanged(Int64, Boolean, Boolean)

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

System.Boolean oldValue

System.Boolean newValue

Overrides

OnClick(EventArgs)

Declaration
protected override void OnClick(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnDropDownCreated()

Declaration
protected override void OnDropDownCreated()
Overrides

OnPropertyChanged(RadPropertyChangedEventArgs)

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

Overrides

OnToggleStateChanged(StateChangedEventArgs)

Raises the ToggleStateChanged event.

Declaration
protected virtual void OnToggleStateChanged(StateChangedEventArgs e)
Parameters
StateChangedEventArgs e

OnToggleStateChanging(StateChangingEventArgs)

Raises the ToggleStateChanging event.

Declaration
protected virtual void OnToggleStateChanging(StateChangingEventArgs e)
Parameters
StateChangingEventArgs e

TranslateArrowDirection(RadDirection)

Declaration
protected virtual ArrowDirection TranslateArrowDirection(RadDirection dropdownDirection)
Parameters
RadDirection dropdownDirection

Returns
ArrowDirection

UpdateOnShortcutsChanged()

Declaration
protected override void UpdateOnShortcutsChanged()
Overrides

Events

ToggleStateChanged

Occurs when the item's toggle state changes.

Declaration
public event StateChangedEventHandler ToggleStateChanged
Event Type
StateChangedEventHandler

ToggleStateChanging

Occurs before the item's toggle state changes.

Declaration
public event StateChangingEventHandler ToggleStateChanging
Event Type
StateChangingEventHandler

Extension Methods