Skip to main content

Bar Item Display Options

Caption and Image

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

WinForms Ribbon Control, DevExpress

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.

Bar Item Image Options - WinForms Ribbon Control, DevExpress

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.

WinForms Ribbon Control Resize, DevExpress

Ribbon Style

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