BarMenuItem Class

[TemplatePart(Name = "PART_Popup", Type = typeof(Popup))]
[TemplatePart(Name = "PART_PopupContentHost", Type = typeof(ResizablePopupContentHost))]
public class BarMenuItem : MenuItem, DUCE.IResource, IAnimatable, IFrameworkInputElement, IInputElement, ISupportInitialize, IHaveResources, IQueryAmbient, IAddChild, IGeneratorHost, IContainItemStorage, ICommandSource, ISupportsCoerceKeyTipText, ISupportsCoerceLabel

public BarMenuItem()

public BarMenuItem(string label)

Parameter	Type	Description
label	System.String	The text label to display.

public bool CanCloneToRibbonQuickAccessToolBar { get; set; }

Property Value

System.Boolean:

true if the control can be cloned to the ribbon quick-access toolbar; otherwise, false. The default value is true.

protected virtual bool CanOpenSubMenu { get; }

Property Value

System.Boolean:

true if the submenu can be opened; otherwise, false.

[Localizability(LocalizationCategory.Text)]
public string Description { get; set; }

Property Value

System.String:

The extended description of the menu item.

See Also

• UseLargeSize

public bool IsInputGestureTextVisible { get; set; }

Property Value

System.Boolean:

true if the input gesture text is allowed to be visible in the user interface; otherwise, false. The default value is true.

[Localizability(LocalizationCategory.NeverLocalize)]
public string Key { get; set; }

Property Value

System.String:

A string that uniquely identifies the control.

[Localizability(LocalizationCategory.Label)]
public string KeyTipText { get; set; }

Property Value

System.String:

The key tip text used to access the control.

[Localizability(LocalizationCategory.Label)]
public string Label { get; set; }

Property Value

System.String:

The text label to display.

public ImageSource LargeImageSource { get; set; }

Property Value

System.Windows.Media.ImageSource:

The System.Windows.Media.ImageSource for a large image.

public ICommand PopupOpeningCommand { get; set; }

Property Value

System.Windows.Input.ICommand:

The System.Windows.Input.ICommand that executes before the menu item's popup is opened, allowing its items to be customized in MVVM scenarios.

public object ScreenTipFooter { get; set; }

Property Value

System.Object:

The screen tip footer content.

public object ScreenTipHeader { get; set; }

Property Value

System.Object:

The screen tip header content.

public ImageSource SmallImageSource { get; set; }

Property Value

System.Windows.Media.ImageSource:

The System.Windows.Media.ImageSource for a small image.

[Localizability(LocalizationCategory.Title)]
public string Title { get; set; }

Property Value

System.String:

The string title.

public bool UseLargeSize { get; set; }

Property Value

System.Boolean:

true if a large size should be used; otherwise, false. The default value is false.

See Also

• Description

protected override void ClearContainerForItemOverride(DependencyObject element, object item)

Parameter	Type	Description
element	System.Windows.DependencyObject	The container element.
item	System.Object	The item.

protected override DependencyObject GetContainerForItemOverride()

Returns

System.Windows.DependencyObject:

The element used to display a specified item.

protected override bool IsItemItsOwnContainerOverride(object item)

Parameter	Type	Description
item	System.Object	Specified item.

Returns

System.Boolean:

true if the item is its own ItemContainer; otherwise, false.

public override void OnApplyTemplate()

protected override void OnClick()

protected override AutomationPeer OnCreateAutomationPeer()

Returns

System.Windows.Automation.Peers.AutomationPeer:

A System.Windows.Automation.Peers.MenuItemAutomationPeer for this MenuItem.

protected override void OnGotKeyboardFocus(KeyboardFocusChangedEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.KeyboardFocusChangedEventArgs	The event data for the GotFocus event.

protected override void OnIsKeyboardFocusWithinChanged(DependencyPropertyChangedEventArgs e)

Parameter	Type	Description
e	System.Windows.DependencyPropertyChangedEventArgs	The event data for the IsKeyboardFocusWithinChanged event.

protected override void OnKeyDown(KeyEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.KeyEventArgs	The event data for the KeyDown event.

protected virtual void OnKeyTipInvoked(KeyTipInvokedEventArgs e)

Parameter	Type	Description
e	KeyTipInvokedEventArgs	The KeyTipInvokedEventArgs containing data related to this event.

protected virtual void OnKeyTipOpening(KeyTipOpeningEventArgs e)

Parameter	Type	Description
e	KeyTipOpeningEventArgs	The KeyTipOpeningEventArgs containing data related to this event.

protected override void OnKeyUp(KeyEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.KeyEventArgs	The System.Windows.Input.KeyEventArgs that contains the event data.

protected override void OnLostKeyboardFocus(KeyboardFocusChangedEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.KeyboardFocusChangedEventArgs	The System.Windows.Input.KeyboardFocusChangedEventArgs that contains event data.

protected override void OnMouseEnter(MouseEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.MouseEventArgs	The event data for the MouseEnter event.

protected override void OnMouseLeave(MouseEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.MouseEventArgs	The event data for the MouseLeave event.

protected override void OnMouseLeftButtonDown(MouseButtonEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.MouseButtonEventArgs	The event data for the MouseLeftButtonDown event.

protected override void OnMouseRightButtonDown(MouseButtonEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.MouseButtonEventArgs	The event data for the MouseRightButtonDown event.

protected override void OnMouseRightButtonUp(MouseButtonEventArgs e)

Parameter	Type	Description
e	System.Windows.Input.MouseButtonEventArgs	The event data for the MouseRightButtonUp event.

protected virtual void OnSubmenuOpening(CancelRoutedEventArgs e)

Parameter	Type	Description
e	CancelRoutedEventArgs	The CancelRoutedEventArgs that contains the event data.

Remarks

This method has no default implementation. Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

protected override void OnToolTipOpening(ToolTipEventArgs e)

Parameter	Type	Description
e	System.Windows.Controls.ToolTipEventArgs	Provides data about the event.

protected override void PrepareContainerForItemOverride(DependencyObject element, object item)

Parameter	Type	Description
element	System.Windows.DependencyObject	Element used to display the specified item.
item	System.Object	Specified item.

public override string ToString()

Returns

System.String:

A string that represents this object.

public event EventHandler<CancelRoutedEventArgs> SubmenuOpening

Event Type

System.EventHandler<CancelRoutedEventArgs>

public static readonly DependencyProperty CanCloneToRibbonQuickAccessToolBarProperty

public static readonly DependencyProperty DescriptionProperty

public static readonly DependencyProperty IsInputGestureTextVisibleProperty

public static readonly DependencyProperty KeyProperty

public static readonly DependencyProperty KeyTipTextProperty

public static readonly DependencyProperty LabelProperty

public static readonly DependencyProperty LargeImageSourceProperty

public static readonly DependencyProperty PopupOpeningCommandProperty

public static readonly DependencyProperty ScreenTipFooterProperty

public static readonly DependencyProperty ScreenTipHeaderProperty

public static readonly DependencyProperty SmallImageSourceProperty

public static readonly RoutedEvent SubmenuOpeningEvent

public static readonly DependencyProperty TitleProperty

public static readonly DependencyProperty UseLargeSizeProperty