ContextQMD
Back to Devexpress

Bar Item Display Options

windowsforms-2517-controls-and-libraries-ribbon-bars-and-menu-ribbon-items-and-item-links-bar-item-display-options.md

latest1.9 KB
Original Source

Bar Item Display Options

  • Sep 22, 2022

Caption and Image

Bar items that represent regular buttons, check buttons, and menus can display the caption and small/large image.

Use the BarItem.Caption property to specify the bar item’s caption.

Use the BarItem.ImageOptions property to specify the images for the active and disabled states. You can specify the raster or vector (SVG) images.

The ImageIndex / DisabledImageIndex and LargeImageIndex / DisabledLargeImageIndex properties allow you to display images from the RibbonControl.Images and RibbonControl.LargeImages collections.

If you specified both large and small images to a bar item, the bar item displays the large image. If the Ribbon Control can not fit bar items with large images, the bar items display small images. If there is no enough space to display the bar item’s caption, the caption is automatically hidden.

Ribbon Style

Use the BarItem.RibbonStyle property to specify whether bar item links display large images and small images with or without text (caption).