Skip to main content
All docs
V25.1
  • ImageCollection<TImage, TInfo>.GetImage(Int32, ISvgPaletteProvider, Nullable<Size>, Nullable<SvgImageColorizationMode>) Method

    Returns a regular raster image of a specific size. This raster image is produced from a source vector image, and colorized according to the provided palette. Throws the ArgumentOutOfRangeException if the collection has no vector image with the given index.

    Namespace: DevExpress.Utils

    Assembly: DevExpress.Utils.v25.1.dll

    NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

    Declaration

    public Image GetImage(
        int index,
        ISvgPaletteProvider palette,
        Size? size = null,
        SvgImageColorizationMode? imageColorizationMode = null
    )

    Parameters

    Name Type Description
    index Int32

    An index of a source vector image within this collection.

    palette DevExpress.Utils.Design.ISvgPaletteProvider

    An ISvgPaletteProvider object that specifies a palette according to which the produced raster image should be colorized. See this article to learn why and how images change their colors depending on skins and palettes: How To: Draw and Use SVG Images.

    Optional Parameters

    Name Type Default Description
    size Nullable<Size> null

    The size of the produced raster image.

    imageColorizationMode Nullable<DevExpress.Utils.SvgImageColorizationMode> null

    The colorization mode for the source SVG image.

    Returns

    Type Description
    Image

    The raster image produced from the source SVG image.

    Remarks

    The code below illustrates how to create a 164x164-pixel raster image from a vector image stored in this SvgImageCollection.

    using DevExpress.Utils.Svg;
    
    var palette = SvgPaletteHelper.GetSvgPalette(
        this.LookAndFeel, DevExpress.Utils.Drawing.ObjectState.Normal);
    simpleButton1.ImageOptions.Image = svgImageCollection1.GetImage(
        "SaveAll", palette, new Size(164, 164), SvgImageColorizationMode.Full);
    

    See the SvgImageCollection class description for more information.

    See Also