Represents a drop down button in CommandBarStripElement.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class CommandBarDropDownButton : RadCommandBarBaseItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, IItemsOwner
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadCommandBarVisualElementRadCommandBarBaseItemCommandBarDropDownButton...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes the drop-down button with the default command-bar image.
public CommandBarDropDownButton()
Fields
The visual arrow segment whose hover state is tracked separately from the button's action area.
protected RadCommandBarArrowButton arrowButton
Properties
Gets the arrow part of the button.
public RadCommandBarArrowButton ArrowPart { get; }
Gets or sets the drop down menu, opened on click.
[Browsable(false)]
public RadDropDownMenu DropDownMenu { get; set; }
Gets menu items collection
[RadEditItemsAction]
[Browsable(true)]
public RadItemOwnerCollection Items { get; }
Implements:
Methods
Creates the owned drop-down menu and arrow segment, then connects their popup and hover events to this item.
protected override void CreateChildElements()
Overrides:
Disposes the drop-down menu owned by this item.
protected override void DisposeManagedResources()
Overrides:
Shares the containing element tree's image list with the drop-down menu after the item is loaded.
protected override void OnLoaded()
Overrides:
On a left-button press, marks the item pressed and attempts to open its drop-down menu.
protected override void OnMouseDown(MouseEventArgs e)
Mouse-button and position data for the event.
Overrides:
Marks the action area as hovered so its state is distinct from the arrow segment.
protected override void OnMouseEnter(EventArgs e)
Event data for the mouse-enter event.
Overrides:
Clears the action/arrow hover state and resets the pressed state when the pointer leaves the item.
protected override void OnMouseLeave(EventArgs e)
Event data for the mouse-leave event.
Overrides:
Resets the pressed state after base mouse-up handling.
protected override void OnMouseUp(MouseEventArgs e)
Mouse-button and position data for the event.
Overrides:
Refreshes the drop-down menu's image list when the root element reports an image-list change.
protected override void OnTunnelEvent(RadElement sender, RoutedEventArgs args)
The element that raised the tunneled event.
argsRoutedEventArgsThe routed event data.
Overrides:
Opens the menu below this item when Items is non-empty, applying the containing control's theme when available and the item's right-to-left setting.
public virtual void ShowDropdown()
Detaches this item's popup-open and popup-close handlers from its current menu.
protected virtual void UnwireDropDownEvents()
Attaches handlers that keep the item's drop-down-shown state synchronized with popup visibility.
protected virtual void WireDropDownEvents()