[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Collapse]Ribbon, Bars and Menu
    [Expand]The Ribbon UI
    [Expand]Visual Elements
    [Collapse]Items and Item Links
      Accessing Bar Items and Links
      Bar Item Behavior Options
      Bar Item Display Options
      Button Groups
      What are Bar Items and Bar Item Links?
     Ribbon Styles
    [Expand]Main Menus
    [Expand]Ribbon Control Designer
    [Expand]Runtime Capabilities
     Known Issues
   [Expand]Popup Menus
    Radial Menu
   [Expand]Common Features
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Bar Item Display Options

Expanded Bar Item Display Options

For bar items that represent regular buttons, check buttons and menus you can specify display captions, and both small and large images. Use the BarItem.Caption property to assign a caption to the item. Images can be assigned to bar items in two ways:

If both large and small images are assigned to a bar item, the large image is used by default. However, if the RibbonControl's width doesn't allow large images to be displayed entirely, small images will be used instead. Also, if there is not enough space to display the item's caption, it will be automatically hidden.

The following image shows how the appearance of bar item links changes when reducing the width of the RibbonControl:

If you want to control how bar item links are displayed onscreen, use the BarItem.RibbonStyle property. It allows you to specify whether large images and small images with or without text are used to draw bar item links. For instance, using this property you can prevent small images without text from being used, but allow large images and small images with text to be used.

Is this topic helpful?​​​​​​​