[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Collapse]Ribbon, Bars and Menu
   [Expand]Common Features
    [Expand]Ribbon Structure
    [Collapse]Populating Ribbon
      Items and Links
      Ribbon Galleries
      Bar Item Display Options
      Bar Item Behavior Options
      MVVM Support
    [Expand]Ribbon Menu
     Runtime Customization
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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 content, and both small and large images. To assign images, use the BarItem.Glyph and BarItem.LargeGlyph properties.

Content can be assigned via the BarItem.Content property. If you want to change the way bar items present their contents, you can specify a data template via the BarItem.ContentTemplate property.

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 entirely displayed, small images will be used instead. Also, if there is not enough space to display the item's caption, it will be automatically hidden.

If you want to control how bar items are displayed in the RibbonControl, 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 items. 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?​​​​​​​