ClassRadMenuItemBase
Represents a base class for the RadMenuItem class.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public abstract class RadMenuItemBase : RadButtonItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IButtonControl, IImageElement, IHierarchicalItem, IItemsOwner, ISiteProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadButtonItemRadMenuItemBase
Derived Classes:
Implements:
Inherited Members
Constructors
RadMenuItemBase()
Initializes a new instance of the RadMenuItemBase class.
Declaration
public RadMenuItemBase()
Fields
IsPopupShownProperty
Declaration
public static readonly RadProperty IsPopupShownProperty
Field Value
PopupDirectionProperty
Declaration
public static readonly RadProperty PopupDirectionProperty
Field Value
SelectedProperty
Declaration
public static readonly RadProperty SelectedProperty
Field Value
Properties
DropDown
Gets the drop down menu associated with this menu item
Declaration
[Browsable(false)]
public RadDropDownMenu DropDown { get; }
Property Value
DropDownHeaderImage
Gets or sets menu header column image
DropDownHeaderText
Gets or sets menu header column text
HandlesKeyboard
Declaration
[Browsable(false)]
public virtual bool HandlesKeyboard { get; set; }
Property Value
HasChildItemsToShow
Gets a values indicating whether this item has child items to show.
Declaration
[Browsable(false)]
public virtual bool HasChildItemsToShow { get; }
Property Value
HasChildren
Gets a value indicating whether this item has child items.
Declaration
[Browsable(false)]
public bool HasChildren { get; }
Property Value
Implements
HierarchyParent
Gets or sets the parent menu item.
Declaration
[Browsable(false)]
public IHierarchicalItem HierarchyParent { get; set; }
Property Value
Implements
IsMainMenuItem
Declaration
[Browsable(false)]
public bool IsMainMenuItem { get; set; }
Property Value
IsOnDropDown
Declaration
[Browsable(false)]
public bool IsOnDropDown { get; }
Property Value
IsPopupShown
Gets a value indiciating that the popup containing this menu item's children is shown.
Declaration
[Browsable(true)]
public bool IsPopupShown { get; }
Property Value
IsRootItem
Gets a value indicating whether this item is in the root items collection.
Declaration
[Browsable(false)]
public bool IsRootItem { get; }
Property Value
Implements
Items
Gets a collection of the child items.
Declaration
public RadItemOwnerCollection Items { get; }
Property Value
Implements
Next
Gets the next child item in the parent item's Items collection.
Declaration
[Browsable(false)]
public RadItem Next { get; }
Property Value
Implements
Owner
Gets or sets the item's owner.
Declaration
[Browsable(false)]
public object Owner { get; set; }
Property Value
Implements
OwnerControl
Returns the control that owns this item. This can be a RadMenu or RadDropDownMenu.
Declaration
[Browsable(false)]
public virtual Control OwnerControl { get; }
Property Value
PopupDirection
Gets or sets the direction of the popup which is opened by this menu item.
Declaration
[Browsable(true)]
public RadDirection PopupDirection { get; set; }
Property Value
Previous
Gets the previous child item in the parent item's Items collection.
Declaration
[Browsable(false)]
public RadItem Previous { get; }
Property Value
Implements
RootItem
Gets the root item of this item's hierarchy.
Declaration
public IHierarchicalItem RootItem { get; }
Property Value
Implements
Selected
Declaration
[Browsable(false)]
public bool Selected { get; set; }
Property Value
ShortcutsHandler
Gets the shortcuts handler for managing keyboard shortcuts.
Declaration
protected override IComponentTreeHandler ShortcutsHandler { get; }
Property Value
Overrides
Methods
AdjustDropDownAlignmentForOrientation()
Declaration
protected virtual void AdjustDropDownAlignmentForOrientation()
AdjustDropDownAlignmentForPopupDirection()
Declaration
protected virtual void AdjustDropDownAlignmentForPopupDirection()
AdjustDropDownAnimations()
Declaration
protected virtual void AdjustDropDownAnimations()
CreateDropDownMenu()
Declaration
protected virtual RadDropDownMenu CreateDropDownMenu()
Returns
DisposeManagedResources()
Disposes managed resources, including the associated image if it's not shared with other items.
Declaration
protected override void DisposeManagedResources()
Overrides
EnsureDropDownCreated()
Declaration
protected virtual void EnsureDropDownCreated()
GetClientRectangle(SizeF)
Declaration
protected override RectangleF GetClientRectangle(SizeF finalSize)
Parameters
finalSize
Returns
Overrides
HideChildItems()
Closes the RadMenuItemBase popup.
Declaration
public virtual void HideChildItems()
InitializeFields()
Initializes the internal state fields for the button item, setting default values for shared image and capture behavior.
Declaration
protected override void InitializeFields()
Overrides
OnBubbleEvent(RadElement, RoutedEventArgs)
Called when the bubble phase of a routed event occurs.
Declaration
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters
sender
The element that originally raised the event.
args
The routed event arguments.
Overrides
OnDoubleClick(EventArgs)
OnDropDownClosed(RadPopupClosedEventArgs)
Raises the DropDownClosed event.
Declaration
protected virtual void OnDropDownClosed(RadPopupClosedEventArgs args)
Parameters
args
An EventArgs that contains the event data.
OnDropDownClosing(RadPopupClosingEventArgs)
Raises the DropDownClosing event.
Declaration
protected virtual void OnDropDownClosing(RadPopupClosingEventArgs args)
Parameters
args
An instance of the RadPopupClosingEventArgs class that contains information about the event.
OnDropDownCreated()
Declaration
protected virtual void OnDropDownCreated()
OnDropDownOpened(EventArgs)
Raises the DropDownOpened event.
OnDropDownOpening(CancelEventArgs)
Raises the DropDownOpening event.
Declaration
protected virtual void OnDropDownOpening(CancelEventArgs args)
Parameters
args
An EventArgs that contains the event data.
OnMouseDown(MouseEventArgs)
Handles the mouse down event by setting the button to pressed state and capturing mouse input when appropriate.
Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
e
The MouseEventArgs containing event data.
Overrides
OnMouseEnter(EventArgs)
Handles the mouse enter event by setting the button to pressed state when in hover click mode or when a press is pending.
OnMouseLeave(EventArgs)
Handles the mouse leave event by releasing the pressed state and managing press-on-return behavior.
OnPropertyChanged(RadPropertyChangedEventArgs)
Handles property changes, specifically releasing the pressed state when the button is disabled.
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
e
The RadPropertyChangedEventArgs containing event data.
Overrides
ProcessMnemonic(char)
This method is not relevant for this class.
ShouldSerializeProperty(PropertyDescriptor)
Determines whether the specified property should be serialized, with special handling for the SvgImageXml property.
Declaration
public override bool? ShouldSerializeProperty(PropertyDescriptor property)
Parameters
property
The PropertyDescriptor representing the property to check for serialization.
Returns
bool?
True if the property should be serialized, false if it should not be serialized, or null for default behavior.
Overrides
ShowChildItems()
Calls the ShowPopup method and displays the child items in a popup window.
Declaration
public virtual void ShowChildItems()
Events
DropDownClosed
Occurs after the menu item dropdown closes.
Declaration
public event RadPopupClosedEventHandler DropDownClosed
Event Value
DropDownClosing
Occurs before the popup is closed.
Declaration
public event RadPopupClosingEventHandler DropDownClosing
Event Value
DropDownCreating
Occurs before the popup is creating.
Declaration
public event RadMenuItemDropDownCreatingEventHandler DropDownCreating
Event Value
DropDownOpened
Occurs after the menu item dropdown opens.
DropDownOpening
Occurs before the menu item dropdown opens.
Declaration
public event CancelEventHandler DropDownOpening
Event Value