[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Expand]Common Features
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.DataAccess.UI
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.DocumentView.Controls
  [Expand]DevExpress.LookAndFeel
  [Expand]DevExpress.LookAndFeel.Helpers
  [Expand]DevExpress.Skins
  [Expand]DevExpress.Snap
  [Expand]DevExpress.Snap.API.Native
  [Expand]DevExpress.Snap.Core
  [Expand]DevExpress.Snap.Core.API
  [Expand]DevExpress.Snap.Core.Fields
  [Expand]DevExpress.Snap.Core.Forms
  [Expand]DevExpress.Snap.Core.Options
  [Expand]DevExpress.Snap.Core.Services
  [Expand]DevExpress.Snap.Extensions
  [Expand]DevExpress.Snap.Extensions.Localization
  [Expand]DevExpress.Snap.Extensions.UI
  [Expand]DevExpress.Snap.Localization
  [Expand]DevExpress.Snap.Options
  [Expand]DevExpress.Snap.Services
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Animation
  [Expand]DevExpress.Utils.Behaviors
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.DragDrop
  [Expand]DevExpress.Utils.Drawing
  [Expand]DevExpress.Utils.Filtering
  [Expand]DevExpress.Utils.Layout
  [Expand]DevExpress.Utils.Menu
  [Expand]DevExpress.Utils.MVVM
  [Expand]DevExpress.Utils.Taskbar
  [Expand]DevExpress.Utils.Taskbar.Core
  [Expand]DevExpress.Utils.UI.Localization
  [Expand]DevExpress.Utils.VisualEffects
  [Expand]DevExpress.Utils.Win
  [Expand]DevExpress.XtraBars
  [Expand]DevExpress.XtraBars.Alerter
  [Expand]DevExpress.XtraBars.Docking
  [Expand]DevExpress.XtraBars.Docking2010
  [Expand]DevExpress.XtraBars.Docking2010.Base
  [Expand]DevExpress.XtraBars.Docking2010.Customization
  [Expand]DevExpress.XtraBars.Docking2010.Views
  [Expand]DevExpress.XtraBars.Docking2010.Views.NativeMdi
  [Expand]DevExpress.XtraBars.Docking2010.Views.Tabbed
  [Expand]DevExpress.XtraBars.Docking2010.Views.Widget
  [Expand]DevExpress.XtraBars.Docking2010.Views.WindowsUI
  [Expand]DevExpress.XtraBars.FluentDesignSystem
  [Expand]DevExpress.XtraBars.Localization
  [Expand]DevExpress.XtraBars.Navigation
  [Collapse]DevExpress.XtraBars.Ribbon
   [Expand]ApplicationMenu Class
   [Expand]AppMenuFileLabel Class
   [Expand]BackstageViewButtonItem Class
   [Expand]BackstageViewClientControl Class
   [Expand]BackstageViewControl Class
   [Expand]BackstageViewControlItemCollecton Class
   [Expand]BackstageViewItem Class
   [Expand]BackstageViewItemBase Class
   [Expand]BackstageViewItemEventArgs Class
    BackstageViewItemEventHandler Delegate
   [Expand]BackstageViewItemSeparator Class
    BackstageViewShowRibbonItems Enumeration
   [Expand]BackstageViewTabItem Class
   [Expand]GalleryControl Class
   [Expand]GalleryDropDown Class
   [Expand]GalleryFilterMenuClickEventArgs Class
   [Expand]GalleryFilterMenuEventArgs Class
   [Expand]GalleryItem Class
   [Expand]GalleryItemClickEventArgs Class
    GalleryItemClickEventHandler Delegate
   [Expand]GalleryItemCollection Class
   [Expand]GalleryItemCustomDrawEventArgs Class
    GalleryItemCustomDrawEventHandler Delegate
   [Expand]GalleryItemEventArgs Class
   [Expand]GalleryItemGroup Class
    GalleryItemGroupCaptionAlignment Enumeration
   [Expand]GalleryItemGroupCollection Class
    GallerySizeMode Enumeration
   [Expand]ImageGalleryFilterMenu Class
    ItemImageLocation Enumeration
   [Expand]RadialMenu Class
   [Expand]RecentButtonItem Class
   [Expand]RecentControlContainerItem Class
   [Expand]RecentHyperlinkItem Class
   [Expand]RecentItemBase Class
   [Expand]RecentItemControl Class
   [Expand]RecentItemEventArgs Class
   [Expand]RecentLabelItem Class
   [Expand]RecentPanelBase Class
   [Expand]RecentPinItem Class
   [Expand]RecentSeparatorItem Class
   [Expand]RecentStackPanel Class
   [Expand]RecentTabItem Class
   [Expand]RecentTextGlyphItemBase Class
   [Expand]RibbonBarItems Class
   [Expand]RibbonControl Class
    RibbonControlColorScheme Enumeration
    RibbonControlStyle Enumeration
   [Expand]RibbonForm Class
    RibbonItemStyles Enumeration
    RibbonMdiMergeStyle Enumeration
   [Expand]RibbonMiniToolbar Class
   [Expand]RibbonMiniToolbarCollection Class
   [Expand]RibbonMiniToolbarOpacityOptions Class
   [Expand]RibbonOptionsTouch Class
   [Expand]RibbonPage Class
   [Expand]RibbonPageCategory Class
    RibbonPageCategoryAlignment Enumeration
   [Expand]RibbonPageCategoryCollection Class
   [Expand]RibbonPageCollection Class
   [Collapse]RibbonPageGroup Class
     RibbonPageGroup Members
    [Expand]RibbonPageGroup Constructor
    [Collapse]RibbonPageGroup Properties
      ActualItemLinks Property
      Alignment Property
      AllowMinimize Property
      AllowTextClipping Property
      Enabled Property
      Glyph Property
      ImageIndex Property
      ImageOptions Property
      Images Property
      ImageUri Property
      ItemLinks Property
      ItemsLayout Property
      KeyTip Property
      MergeOrder Property
      Name Property
      OriginalPageGroup Property
      Page Property
      Ribbon Property
      ShowCaptionButton Property
      State Property
      SuperTip Property
      Tag Property
      Text Property
      ToolbarContentButtonLink Property
      Visible Property
    [Expand]RibbonPageGroup Events
    [Expand]RibbonPageGroup Methods
   [Expand]RibbonPageGroupCollection Class
   [Expand]RibbonPageGroupEventArgs Class
    RibbonPageGroupEventHandler Delegate
    RibbonPageGroupItemsLayout Enumeration
   [Expand]RibbonQuickAccessToolbar Class
    RibbonQuickAccessToolbarLocation Enumeration
   [Expand]RibbonStatusBar Class
    ShowPageHeadersMode Enumeration
  [Expand]DevExpress.XtraBars.Ribbon.Gallery
  [Expand]DevExpress.XtraBars.Ribbon.ViewInfo
  [Expand]DevExpress.XtraBars.ToastNotifications
  [Expand]DevExpress.XtraBars.ToolbarForm
  [Expand]DevExpress.XtraBars.Utils
  [Expand]DevExpress.XtraBars.WinRTLiveTiles
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Designer
  [Expand]DevExpress.XtraCharts.Wizard
  [Expand]DevExpress.XtraDataLayout
  [Expand]DevExpress.XtraDiagram
  [Expand]DevExpress.XtraDiagram.Docking
  [Expand]DevExpress.XtraDiagram.Options
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.ButtonPanel
  [Expand]DevExpress.XtraEditors.Calendar
  [Expand]DevExpress.XtraEditors.Camera
  [Expand]DevExpress.XtraEditors.Container
  [Expand]DevExpress.XtraEditors.Controls
  [Expand]DevExpress.XtraEditors.CustomEditor
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraEditors.Filtering
  [Expand]DevExpress.XtraEditors.Mask
  [Expand]DevExpress.XtraEditors.Persistent
  [Expand]DevExpress.XtraEditors.Repository
  [Expand]DevExpress.XtraEditors.ViewInfo
  [Expand]DevExpress.XtraFilterEditor
  [Expand]DevExpress.XtraGauges.Presets.Styles
  [Expand]DevExpress.XtraGauges.Win
  [Expand]DevExpress.XtraGauges.Win.Base
  [Expand]DevExpress.XtraGauges.Win.Gauges.Circular
  [Expand]DevExpress.XtraGauges.Win.Gauges.Digital
  [Expand]DevExpress.XtraGauges.Win.Gauges.Linear
  [Expand]DevExpress.XtraGauges.Win.Gauges.State
  [Expand]DevExpress.XtraGrid
  [Expand]DevExpress.XtraGrid.Columns
  [Expand]DevExpress.XtraGrid.EditForm
  [Expand]DevExpress.XtraGrid.FilterEditor
  [Expand]DevExpress.XtraGrid.Localization
  [Expand]DevExpress.XtraGrid.Views.BandedGrid
  [Expand]DevExpress.XtraGrid.Views.BandedGrid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Base
  [Expand]DevExpress.XtraGrid.Views.Base.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Card
  [Expand]DevExpress.XtraGrid.Views.Card.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Grid
  [Expand]DevExpress.XtraGrid.Views.Grid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Layout
  [Expand]DevExpress.XtraGrid.Views.Layout.Events
  [Expand]DevExpress.XtraGrid.Views.Layout.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Printing
  [Expand]DevExpress.XtraGrid.Views.Tile
  [Expand]DevExpress.XtraGrid.Views.WinExplorer
  [Expand]DevExpress.XtraGrid.WinExplorer
  [Expand]DevExpress.XtraLayout
  [Expand]DevExpress.XtraLayout.Converter
  [Expand]DevExpress.XtraLayout.Customization
  [Expand]DevExpress.XtraLayout.HitInfo
  [Expand]DevExpress.XtraLayout.Localization
  [Expand]DevExpress.XtraLayout.Utils
  [Expand]DevExpress.XtraMap
  [Expand]DevExpress.XtraMap.Printing
  [Expand]DevExpress.XtraNavBar
  [Expand]DevExpress.XtraNavBar.ViewInfo
  [Expand]DevExpress.XtraPdfViewer
  [Expand]DevExpress.XtraPdfViewer.Commands
  [Expand]DevExpress.XtraPdfViewer.Extensions
  [Expand]DevExpress.XtraPdfViewer.Localization
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.Control
  [Expand]DevExpress.XtraPrinting.Preview
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports.UI
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Commands
  [Expand]DevExpress.XtraRichEdit.Export
  [Expand]DevExpress.XtraRichEdit.Import
  [Expand]DevExpress.XtraRichEdit.Menu
  [Expand]DevExpress.XtraScheduler
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.GoogleCalendar
  [Expand]DevExpress.XtraScheduler.Printing
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Reporting.UI
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Localization
  [Expand]DevExpress.XtraSplashForm
  [Expand]DevExpress.XtraSplashScreen
  [Expand]DevExpress.XtraSpreadsheet
  [Expand]DevExpress.XtraSpreadsheet.Services
  [Expand]DevExpress.XtraTab
  [Expand]DevExpress.XtraTab.Buttons
  [Expand]DevExpress.XtraTab.ViewInfo
  [Expand]DevExpress.XtraTabbedMdi
  [Expand]DevExpress.XtraToolbox
  [Expand]DevExpress.XtraTreeList
  [Expand]DevExpress.XtraTreeList.Columns
  [Expand]DevExpress.XtraTreeList.Data
  [Expand]DevExpress.XtraTreeList.Localization
  [Expand]DevExpress.XtraTreeList.Menu
  [Expand]DevExpress.XtraTreeList.Nodes
  [Expand]DevExpress.XtraTreeList.Nodes.Operations
  [Expand]DevExpress.XtraTreeList.StyleFormatConditions
  [Expand]DevExpress.XtraTreeMap
  [Expand]DevExpress.XtraTreeMap.Printing
  [Expand]DevExpress.XtraVerticalGrid
  [Expand]DevExpress.XtraVerticalGrid.Events
  [Expand]DevExpress.XtraVerticalGrid.Localization
  [Expand]DevExpress.XtraVerticalGrid.Rows
  [Expand]DevExpress.XtraWaitForm
  [Expand]DevExpress.XtraWizard
[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]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

RibbonPageGroup.ImageOptions Property

Provides access to properties that allow you to set up raster and vector images for this RibbonPageGroup.

Namespace:DevExpress.XtraBars.Ribbon
Assembly:DevExpress.XtraBars.v19.1.dll

Expanded Syntax

Property value

Type: RibbonPageGroupImageOptions
A DevExpress.XtraBars.Ribbon.RibbonPageGroupImageOptions object that stores image-related properties.

Expanded Remarks

The ImageOptions property groups all properties that allow you to assign and customize an icon for a UI element.

Typically, this group provides access to the following properties. Note that some of them can be unavailable for this specific class.

Property

Description

Image

LargeImage

DisabledImage

etc.

Properties that allow you to assign regular raster images from a local storage or DevExpress Image Gallery.

SvgImage

DisabledSvgImage

etc.

Traditional ...Image property counterparts that allow you to assign vector images.

Vector images support high-quality scaling, so the single SvgImage property replaces all one-size properties for traditional raster images (SmallImage, LargeImage, etc.). To resize a SVG image, use ...Size properties (see below).

SvgImageSize

DisabledSvgImageSize

etc.

Explicitly specify vector image sizes. These properties are ignored in case the icon size is managed internally or items provide other properties to control icon sizes.

For example, you can manually resize a BarItem vector icon when this item is hosted within a BarManager. However, should the same item belong to a Ribbon, custom size settings will not be in effect since the predominant property is BarItem.RibbonStyle.

Images

LargeImages

etc.

Often provided by items' parent controls, these properties accept image collections, which store a complete icon set for all items. Once you specify such a collection, use the ...Index properties for each item to choose an icon (see below).

ImageIndex

LargeImageIndex

DisabledImageIndex

etc.

Use these properties to select a desired icon from the ...Images collection.

ImageUri

A unified resource identifier that allows your items to automatically choose the most suitable image from the Image Gallery based on the icon name, size and the currently applied application skin.

AllowGlyphSkinning

Specifies whether or not the Glyph Skinning feature is enabled. This feature works only for raster icons.

SvgImageColorizationMode

If a vector icon meets DevExpress color requirements, DevExpress controls can adjust this icon's colors according to the active application Skin. This property allows you to choose how this colorization works.

  • Default or Full - all compatible icons are colorized with default colorization engine settings.
  • CommonPalette - all compatible icons are colorized with colors stored in the "Icon Colors" section of a palette. Individual palettes that bar items, Accordion items, and other controls may have are ignored.
  • None - icons are never colorized and are shown as is.

The figure below illustrates an icon from the DevExpress Image Gallery as it appears in three bar items with different SvgImageColorizationMode settings.

Expanded See Also

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