Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

XtraForm.IconOptions Property

Provides access to image settings that allow you to assign raster and vector images to XtraForms (instead of traditional .ico images).

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.Utils.v24.2.dll

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

#Declaration

[DXCategory("Appearance")]
public FormIconOptions IconOptions { get; }

#Property Value

Type Description
DevExpress.XtraEditors.FormIconOptions

Provides access to form icon-related settings.

#Remarks

Use this property to set up vector or raster image for this form instance.

this.IconOptions.SvgImage = Properties.Resources.barcodeImage;

Note that images assigned through the IconOptions object (IconOptions.Image, IconOptions.SvgImage, IconOptions.ImageURI) have priority over the standard Icon property.

A forms icon size is fixed, you cannot use the IconOptions.SvgImageSize property to change this size.

If you need to set up the same image for all DevExpress forms in your application, use the static FormIconOptions.Default property.

using DevExpress.XtraEditors;

FormIconOptions.Default.SvgImage = Properties.Resources.avocado;

Note

Use the IconOptions.Image and IconOptions.LargeImage properties to assign raster images with different resolutions to the XtraForm (to avoid blurring). The Image property specifies the image displayed in the title bar. The LargeImage property specifies the image displayed in the taskbar.

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the IconOptions property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also