BarButtonItem Properties
A button command in the Ribbon UI, toolbar, or popup menu.Name | Description |
---|---|
AccessibleDescription | Gets or sets the object’s description used by accessibility client applications. Inherited from BarItem. |
AccessibleName | Gets or sets the object’s name used by accessibility client applications. Inherited from BarItem. |
AccessibleRole | Gets or sets the object’s accessible role. Inherited from BarItem. |
ActAsDropDown | Gets or sets whether this BarButtonItem should be displayed as a single element. This property is in effect when the BarButtonItem.ButtonStyle property is set to BarButtonStyle.DropDown. |
Alignment | Gets or sets the horizontal alignment of the bar item’s link(s). Inherited from BarItem. |
AllowAllUp | Gets or sets whether all the button items in a group can be in the normal (elevated) state at a time. Inherited from BarBaseButtonItem. |
AllowDrawArrow | Gets or sets whether an arrow for the pop-up button should be displayed. |
AllowDrawArrowInMenu | Gets or sets whether the drop-down BarButtonItem should display an arrow in menus. |
AllowGlyphSkinning | Gets or sets whether glyphs for this BarItem should be painted using the text foreground color. Inherited from BarItem. |
AllowHtmlText | Gets or sets whether the BarItem.Caption and BarItem.Description can be formatted using HTML tags. Inherited from BarItem. |
AllowRightClickInMenu | Gets or sets if the current command’s functionality is invoked via the right mouse click when in a sub-menu or popup menu. Inherited from BarItem. |
AllowStubGlyph | Gets or sets whether or not this item and all its links should display a stub glyph when it has no custom icon assigned. Inherited from BarItem. |
Appearance | Provides access to the appearance settings for the current bar item, applied when the bar item is in the regular state. Inherited from BarItem. |
AppearanceDisabled |
Provides access to the appearance settings for the current bar item, applied when the bar item is disabled. This property is supported for bar items used within a RibbonControl. Inherited from BarItem. |
BindingContext | Gets or sets a BindingContext object that manages data bindings for this BarItem. Inherited from BarItem. |
Border | Gets or sets the border style for links that refer to the current item. Inherited from BarItem. |
BorderStyle | Obsolete. This member is not supported. Inherited from BarItem. |
ButtonStyle | Get or sets the button item’s style which determines how the current bar button item functions. |
CanDown | Gets a value indicating whether the button item has two states (normal and pressed). Inherited from BarBaseButtonItem. |
CanPressDropDownButton | Gets a value indicating whether the Dropdown button of the BarButtonItem component can be pressed. |
CanRaiseEvents protected | Gets a value indicating whether the component can raise an event. Inherited from Component. |
Caption | Gets or sets the BarButtonItem‘s caption. |
Category | Gets or sets a category where the bar item is displayed. Inherited from BarItem. |
CategoryGuid | Gets or sets a globally unique identifier (GUID) that identifies the category where the item is displayed. Inherited from BarItem. |
CategoryIndex | Obsolete. Gets or sets the index of the category to which the current item belongs. Inherited from BarItem. |
CausesValidation | Gets or sets whether data validation is performed on the currently focused control when clicking on the bar item. Inherited from BarItem. |
CloseOwnerMenuOnlyOnClick | Gets or sets whether only the submenu owning the current button is closed on a click, but not precedent submenus. Inherited from BarBaseButtonItem. |
CloseRadialMenuOnItemClick | Gets or sets whether clicking the current BarButtonItem‘s link within a RadialMenu should close this menu. |
CloseSubMenuOnClick | Gets or sets whether a submenu which contains the button item’s link is closed when the link is clicked. Inherited from BarBaseButtonItem. |
CloseSubMenuOnClickMode | Gets or sets whether a click on the button closes the submenu that contains this button. Inherited from BarBaseButtonItem. |
Command |
Gets or sets the ICommand whose Execute(Object) method will be called when the Click event is invoked.
|
CommandParameter |
Gets or sets the parameter that is passed to the command specified by the Command property.
|
Container | Gets the IContainer that contains the Component. Inherited from Component. |
ContentHorizontalAlignment | Gets or sets the horizontal alignment mode for this BarItem‘s content. Inherited from BarItem. |
DataBindings | Provides access to the collection of data bindings for the BarItem. Inherited from BarItem. |
DefaultDropDownLink | Assigns all core settings of a target link (caption, image, click event handler, and others) to this Bar Button Item. |
Description | Gets or sets the BarButtonItem‘s description. |
DescriptionMaxWidth | Gets or sets the maximum width of this item’s description. Bar Items display their descriptions in Customization Forms, and inside submenus with the LargeImagesTextDescription draw mode. Inherited from BarItem. |
DesignMode protected | Gets a value that indicates whether the Component is currently in design mode. Inherited from Component. |
Down | Gets or sets a value indicating whether the button item is pressed down. Inherited from BarBaseButtonItem. |
DropDownControl | Gets or sets a Dropdown control for the BarButtonItem component. |
DropDownEnabled | Gets or sets a value indicating whether a dropdown control, assigned to the BarButtonItem.DropDownControl property, is enabled. |
DropDownSuperTip | Gets or sets a SuperToolTip object that is displayed when the current item displays a separate dropdown arrow and this arrow is hot-tracked. Inherited from BarItem. |
Enabled | Determines whether the current BarItem is active. Inherited from BarItem. |
Events protected | Gets the list of event handlers that are attached to this Component. Inherited from Component. |
Font | Gets the font to display links of the current item. Inherited from BarItem. |
Glyph | Gets or sets the BarButtonItem‘s regular icon. |
GlyphDisabled | Gets or sets a regular icon for the disabled BarButtonItem. |
GroupIndex | Gets or sets the button’s group index. This property is in effect when the current object acts as a check button. Inherited from BarBaseButtonItem. |
Hint | Specifies the bar item’s regular hint. |
Id | Uniquely identifies the current BarItem. Inherited from BarItem. |
ImageIndex | Gets or sets the index of a regular icon assigned to the BarButtonItem. |
ImageIndexDisabled | Gets or sets the index of the image displayed within corresponding links when they are disabled. Inherited from BarItem. |
ImageOptions | Provides access to properties that affect this button’s icon. |
Images | Gets the object which contains images that can be displayed within the current item. Inherited from BarItem. |
ImageToTextAlignment | Specifies whether the bar item image should go before or after this item caption. Inherited from BarBaseButtonItem. |
ImageUri |
Gets or sets the uniform resource identifier of the image in the DX Image Gallery displayed in the current item. A specific version of the addressed image is automatically chosen, based on the app context (the current skin and required image size). |
IsAllowHtmlText | Gets whether HTML tags can be used to format bar item captions. Inherited from BarItem. |
IsImageExist | Gets whether an image which is associated with the bar item actually exists. Inherited from BarItem. |
IsLargeImageExist | Gets whether a large image which is associated with the bar item actually exists. Inherited from BarItem. |
ItemAppearance | Specifies appearance settings for this item in different states. Inherited from BarItem. |
ItemClickFireMode | Gets or sets when the Click events for the bar item fire, immediately or asynchronously, after all events in the system event queue are processed. Inherited from BarItem. |
ItemInMenuAppearance | Specifies appearance settings for this item when it is displayed in a sub-menu or pop-up menu. Inherited from BarItem. |
ItemShortcut | Gets or sets the shortcut used to access the associated links with the keyboard. Inherited from BarItem. |
LargeGlyph | Gets or sets the BarButtonItem‘s large icon. Use the ImageOptions.LargeImage property instead. |
LargeGlyphDisabled | Gets or sets the large icon for the disabled BarButtonItem. |
LargeImageIndex | Gets or sets the index of a large icon assigned to the BarButtonItem. |
LargeImageIndexDisabled | Gets or sets the index of the large image which is displayed within the disabled item’s link(s). Inherited from BarItem. |
LargeImages | Gets the source of large images. Inherited from BarItem. |
LargeWidth | Gets or sets the width of links corresponding to the current item, when they are painted using the RibbonItemStyles.Large paint style. This property is in effect for bar item links displayed within the Ribbon Control and RibbonStatusBar controls. Inherited from BarItem. |
Links | Gets the collection of links to the bar item. Inherited from BarItem. |
Manager | Specifies the BarManager responsible for managing the current item. Inherited from BarItem. |
MergeOrder | Defines the visual position of the bar item after merging bars on a parent MDI form. Inherited from BarItem. |
MergeType | Gets or sets how the item behaves during merge operations in MDI applications. Inherited from BarItem. |
Name | Gets or sets the BarItem‘s name. Inherited from BarItem. |
OwnFont | Obsolete. Specifies the font used to display the captions of links corresponding to this item. Inherited from BarItem. |
PaintStyle | Specifies the style with which to display a specific BarItem within a bar. Inherited from BarItem. |
RememberLastCommand | Gets or sets whether the current Split Button should repeat the last selected command from its drop-down when clicked. |
RibbonStyle | Gets or sets the options that specify the bar item’s possible states within a Ribbon Control. Inherited from BarItem. |
SearchTags | Gets or sets a comma-separated list of keywords by which this bar item can be found using the ribbon search menu. Inherited from BarItem. |
ShortCut | Obsolete. Specifies the shortcut key combination for the current item. Inherited from BarItem. |
ShortcutKeyDisplayString | Gets or sets a custom display string for the shortcut assigned to the item via the BarItem.ItemShortcut property. Inherited from BarItem. |
ShowInCustomizationForm | Gets or sets whether the bar item is visible at runtime in the Customization Window. Inherited from BarItem. |
ShowItemShortcut | Gets or sets whether this BarItem should display its shortcut in sub-menus and pop-up menus. Inherited from BarItem. |
ShowToolTip | Gets or sets whether this item should display its hint when hovered. Inherited from BarItem. |
Site | Gets or sets the ISite of the Component. Inherited from Component. |
Size | Gets or sets the BarItem‘s size. Not supported in Ribbon UI. Inherited from BarItem. |
SmallWithoutTextWidth | Gets or sets the width of links corresponding to the current item, when they are painted using the RibbonItemStyles.SmallWithoutText paint style. This property is in effect for bar item links displayed within the Ribbon Control and RibbonStatusBar controls. Inherited from BarItem. |
SmallWithTextWidth | Gets or sets the width of links corresponding to the current item, when they are painted using the RibbonItemStyles.SmallWithText paint style. This property is in effect for bar item links displayed within the Ribbon Control and RibbonStatusBar controls. Inherited from BarItem. |
SuperTip | Gets or sets the Super Tip for the current BarButtonItem. |
Tag | Gets or sets an object that contains data on the current item. Inherited from BarItem. |
UseOwnFont | Obsolete. Gets or sets whether the item’s links are painted using the item’s own font (Appearance.Font). Inherited from BarItem. |
Visibility | Specifies when the item is visible. Inherited from BarItem. |
VisibleInSearchMenu | Gets or sets whether the bar item can be found using the ribbon search menu. Inherited from BarItem. |
VisibleWhenVertical | Determines whether an item is visible when the bar is vertically oriented . Inherited from BarItem. |
Width | When overridden in a derived class, this property specifies the current item width. Inherited from BarItem. |
See Also