ContextItem.ImageOptions Property

Provides access to all properties that allow you to assign and customize a glyph for this ContextItem.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v20.1.dll

Declaration

[DXCategory("Appearance")]
[Browsable(false)]
public ContextItemImageOptions ImageOptions { get; }
<DXCategory("Appearance")>
<Browsable(False)>
Public ReadOnly Property ImageOptions As ContextItemImageOptions

Property Value

Type Description
DevExpress.Utils.ContextItemImageOptions

A DevExpress.Utils.ContextItemImageOptions object that stores all properties that allow you to assign and customize a glyph for this ContextItem.

Remarks

The ImageOptions property provides settings that allow you to assign and customize icons for a UI element.

NOTE

The following list shows settings the ImageOptions object provides for most controls. Some of these settings may be unavailable for the current control.

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. colorizationmode

Use the ImageOptions property to specify glyphs for the this ContextItem in the normal and hovered states, respectively.

The ContextItem.Glyph property is equivalent to the ImageOptions.Image property.

See Also