Skip to main content
Bar

BarButtonItem Properties

Represents a bar button item.
Name Description
ActualCustomizationContent

For internal use. This is a dependency property.

Inherited from BarItem.
ActualCustomizationGlyph

For internal use. This is a dependency property.

Inherited from BarItem.
Alignment

Gets or sets the default alignment of bar item links corresponding to the current bar item, when they are displayed within a bar. This is a dependency property.

Inherited from BarItem.
AllowDrop Gets or sets a value that indicates whether this element can be used as the target of a drag-and-drop operation. Inherited from ContentElement.
AllowGlyphTheming Gets or sets whether the BarItem glyph is colored according to the currently applied theme. Inherited from BarItem.
AreAnyTouchesCaptured Gets a value that indicates whether at least one touch is captured to this element. Inherited from ContentElement.
AreAnyTouchesCapturedWithin Gets a value that indicates whether at least one touch is captured to this element or to any child elements in its visual tree. Inherited from ContentElement.
AreAnyTouchesDirectlyOver Gets a value that indicates whether at least one touch is pressed over this element. Inherited from ContentElement.
AreAnyTouchesOver Gets a value that indicates whether at least one touch is pressed over this element or any child elements in its visual tree. Inherited from ContentElement.
Background Gets or sets the brush used to paint the BarItem’s background. This is a dependency property. Inherited from BarItem.
Badge Gets or sets the BarItem’s BadgeControl. This is a dependency property. Inherited from BarItem.
BarItemDisplayMode Gets or sets how links to the current bar item are displayed on-screen. This is a dependency property. Inherited from BarItem.
BarItemName Gets or sets the bar item’s name. This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from BarItem.
BindingGroup Gets or sets the BindingGroup that is used for the element. Inherited from FrameworkContentElement.
BorderBrush Gets or sets the brush used to paint a BarItem’s borders. This is a dependency property. Inherited from BarItem.
BorderThickness Gets or sets the thickness of a BarItem’s border. This is a dependency property. Inherited from BarItem.
Category

Gets or sets the category to which the bar item belongs. This is a dependency property.

Inherited from BarItem.
CategoryName

Gets or sets the name of the category to which the bar item belongs. This is a dependency property.

Inherited from BarItem.
CloseSubMenuOnClick Gets or sets whether the sub-menu that contains this BarButtonItem should be closed when an end-user clicks it.
Command

Gets or sets the command to invoke when the bar item is clicked. This is a dependency property.

Inherited from BarItem.
CommandBindings Gets a collection of CommandBinding objects that are associated with this element. Inherited from ContentElement.
CommandParameter

Gets or sets the parameter to pass to the BarItem.Command. This is a dependency property.

Inherited from BarItem.
CommandTarget

Gets or sets the element on which to raise the BarItem.Command. This is a dependency property.

Inherited from BarItem.
Content

Gets or sets the bar item’s content. This is a dependency property.

Inherited from BarItem.
ContentTemplate

Gets or sets the template used to display the bar item’s BarItem.Content. This is a dependency property.

Inherited from BarItem.
ContentTemplateSelector

Gets or sets an object that chooses the BarItem.ContentTemplate based on custom logic. This is a dependency property.

Inherited from BarItem.
ContextMenu Gets or sets the context menu element that should appear whenever the context menu is requested via user interface (UI) from within this element. Inherited from FrameworkContentElement.
CornerRadius Gets or sets the BarItem’s corner radius. This is a dependency property. Inherited from BarItem.
Cursor Gets or sets the cursor that displays when the mouse pointer is over this element. Inherited from FrameworkContentElement.
CustomGlyphSize Gets or sets the size of the bar item’s glyph. The CustomGlyphSize property affects the glyph size if the BarItem.GlyphSize property is set to Custom. This is a dependency property. Inherited from BarItem.
CustomizationContent

Gets or sets the data representing the current bar item in the Customization Window. This is a dependency property.

Inherited from BarItem.
CustomizationGlyph

Gets or sets the image displayed for the current bar item in the Customization Window. This is a dependency property.

Inherited from BarItem.
DataContext Gets or sets the data context for an element when it participates in data binding. Inherited from FrameworkContentElement.
DefaultStyleKey protected Gets or sets the key to use to find the style template for this control in themes. Inherited from FrameworkContentElement.
DependencyObjectType Gets the DependencyObjectType that wraps the CLR type of this instance. Inherited from DependencyObject.
Description Gets or sets the bar item’s description. This is a dependency property. Inherited from BarItem.
DescriptionTemplate Gets or sets a template for the current BarItem object’s Description. This is a dependency property. Inherited from BarItem.
Dispatcher Gets the Dispatcher this DispatcherObject is associated with. Inherited from DispatcherObject.
Focusable Gets or sets a value that indicates whether the element can receive focus. Inherited from ContentElement.
FocusVisualStyle Gets or sets an object that enables customization of appearance, effects, or other style characteristics that will apply to this element when it captures keyboard focus. Inherited from FrameworkContentElement.
ForceCursor Gets or sets a value indicating whether this FrameworkContentElement should force the user interface (UI) to render the cursor as declared by this instance’s Cursor property. Inherited from FrameworkContentElement.
Foreground Gets or sets the brush used to paint the BarItem’s foreground. This is a dependency property. Inherited from BarItem.
Glyph Gets or sets the item’s small image. This is a dependency property. Inherited from BarItem.
GlyphAlignment

Gets or sets the alignment of the current bar item’s image. This is a dependency property.

Inherited from BarItem.
GlyphSize

Gets or sets whether a small or large image is displayed by the bar item. This is a dependency property.

Inherited from BarItem.
GlyphTemplate Gets or sets a template for the current BarItem object’s BarItem.Glyph. This is a dependency property. Inherited from BarItem.
HasAnimatedProperties Gets a value that indicates whether this element has any animated properties. Inherited from ContentElement.
Hint

Gets or sets the data representing the description of the bar item’s hint. This is a dependency property.

Inherited from BarItem.
InputBindings Gets the collection of input bindings that are associated with this element. Inherited from ContentElement.
InputScope Gets or sets the context for input used by this FrameworkContentElement. Inherited from FrameworkContentElement.
IsEnabled Gets or sets a value that indicates whether this element is enabled in the user interface (UI). Inherited from ContentElement.
IsFocused Gets a value that determines whether this element has logical focus. Inherited from ContentElement.
IsInitialized Gets a value indicating whether this element has been initialized, either by being loaded as Extensible Application Markup Language (XAML), or by explicitly having its EndInit() method called. Inherited from FrameworkContentElement.
IsInputMethodEnabled Gets a value that indicates whether an input method system, such as an Input Method Editor (IME), is enabled for processing the input to this element. Inherited from ContentElement.
IsKeyboardFocused Gets a value that indicates whether this element has keyboard focus. Inherited from ContentElement.
IsKeyboardFocusWithin Gets a value that indicates whether keyboard focus is anywhere within the element or child elements. Inherited from ContentElement.
IsLoaded Gets a value indicating whether this element has been loaded for presentation. Inherited from FrameworkContentElement.
IsMouseCaptured Gets a value that indicates whether the mouse is captured by this element. Inherited from ContentElement.
IsMouseCaptureWithin Gets a value that determines whether mouse capture is held by this element or by child elements in its element tree. Inherited from ContentElement.
IsMouseDirectlyOver Gets a value that indicates whether the position of the mouse pointer corresponds to hit test results, which take element compositing into account. Inherited from ContentElement.
IsMouseOver Gets a value that indicates whether the mouse pointer is located over this element (including visual child elements, or its control compositing). Inherited from ContentElement.
IsPrivate Gets or sets whether the current bar item is for internal use. This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from BarItem.
IsSealed Gets a value that indicates whether this instance is currently sealed (read-only). Inherited from DependencyObject.
IsStylusCaptured Gets a value that indicates whether the stylus is captured to this element. Inherited from ContentElement.
IsStylusCaptureWithin Gets a value that determines whether stylus capture is held by this element, including child elements and control compositing. Inherited from ContentElement.
IsStylusDirectlyOver Gets a value that indicates whether the stylus position corresponds to hit test results, which take element compositing into account. Inherited from ContentElement.
IsStylusOver Gets a value that indicates whether the stylus is located over this element (including visual child elements). Inherited from ContentElement.
IsVisible

Gets or sets whether links that refer to the current item are visible. This is a dependency property.

Inherited from BarItem.
ItemTypeName Returns the bar item’s type name. This member supports the internal infrastructure, and is not intended to be used directly from your code. Inherited from BarItem.
KeyGesture Gets or sets a keyboard combination that can be used to invoke the current bar item’s functionality. This is a dependency property. Inherited from BarItem.
KeyTip Gets or sets the Key Tip used to invoke the bar item’s functionality. This is a dependency property. Inherited from BarItem.
Language Gets or sets localization/globalization language information that applies to an individual element. Inherited from FrameworkContentElement.
LargeGlyph

Gets or sets the item’s large image. This is a dependency property.

Inherited from BarItem.
LargeGlyphTemplate Gets or sets a template for the current BarItem object’s BarItem.LargeGlyph. This is a dependency property. Inherited from BarItem.
Links Gets the collection of links that refer to the current item. Inherited from BarItem.
Margin Gets or sets the outer indents around the BarItem. This is a dependency property. Inherited from BarItem.
MediumGlyph Gets or sets the item’s medium-size image. This is a dependency property. Inherited from BarItem.
MediumGlyphTemplate Gets or sets a template for the current BarItem object’s BarItem.MediumGlyph. This is a dependency property. Inherited from BarItem.
MergeOrder Gets or sets the position index for all links of the current BarItem in merged bars. Inherited from BarItem.
MergeType Gets or sets the merge behavior for all links of the current BarItem. Inherited from BarItem.
Name Gets or sets the identifying name of the element. The name provides an instance reference so that programmatic code-behind, such as event handler code, can refer to an element once it is constructed during parsing of XAML. Inherited from FrameworkContentElement.
OverridesDefaultStyle Gets or sets a value indicating whether this element incorporates style properties from theme styles. Inherited from FrameworkContentElement.
Padding Gets or sets the inner indents around the BarItem. This is a dependency property. Inherited from BarItem.
Parent Gets the parent in the logical tree for this element. Inherited from FrameworkContentElement.
Resources Gets or sets the current locally-defined resource dictionary. Inherited from FrameworkContentElement.
RibbonStyle

Gets or sets the options that specify the bar item link’s possible states within a RibbonControl. This is a dependency property.

Inherited from BarItem.
SectorIndex Gets or sets the index of the sector in which the current bar item is displayed. This is a dependency property. Inherited from BarItem.
ShowKeyGesture Gets or sets whether key shortcuts are visible for the current BarItem‘s links displayed in menus. This is a dependency property. Inherited from BarItem.
ShowScreenTip Gets or sets whether a tooltip is allowed for the current bar item. Inherited from BarItem.
Style Gets or sets the style to be used by this element. Inherited from FrameworkContentElement.
SuperTip

Gets or sets a customizable ToolTip for the current bar item. This is a dependency property.

Inherited from BarItem.
Tag Gets or sets an arbitrary object value that can be used to store custom information about this element. Inherited from FrameworkContentElement.
TemplatedParent Gets a reference to the template parent of this element. This property is not relevant if the element was not created through a template. Inherited from FrameworkContentElement.
ToolTip Gets or sets the tool-tip object that is displayed for this element in the user interface (UI). Inherited from FrameworkContentElement.
TouchesCaptured Gets all touch devices that are captured to this element. Inherited from ContentElement.
TouchesCapturedWithin Gets all touch devices that are captured to this element or any child elements in its visual tree. Inherited from ContentElement.
TouchesDirectlyOver Gets all touch devices that are over this element. Inherited from ContentElement.
TouchesOver Gets all touch devices that are over this element or any child elements in its visual tree. Inherited from ContentElement.
Triggers Gets or sets a collection of ItemTriggerBase objects that apply property values based on specified conditions. Inherited from BarItem.
UseLightweightTemplates Gets or sets whether to enable optimized mode for all links created for this item. This is a dependency property. Inherited from BarItem.
VisibleLinkInfos Inherited from BarItem.
See Also