RepositoryItemCheckEdit.ImageOptions Property
Provides access to options specifying vector or raster glyphs for the check box in the checked, unchecked and indeterminate states.
Namespace: DevExpress.XtraEditors.Repository
Assembly: DevExpress.XtraEditors.v23.2.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
Property Value
| Type | Description |
|---|---|
| DevExpress.Utils.Drawing.CheckImageOptions | A DevExpress.Utils.Drawing.CheckImageOptions object that comprises options specifying vector or raster glyphs for the check box in the checked, unchecked and indeterminate states. |
Remarks
If the CheckBoxOptions.Style property (see RepositoryItemCheckEdit.CheckBoxOptions) is set to Custom, you can use ImageOptions to customize the check box glyph in the unchecked, checked and indeterminate states. To customize glyphs you can:
specify vector glyphs and their size:
- SvgImageUnchecked — Gets or sets a vector glyph for the unchecked state;
- SvgImageChecked — Gets or sets a vector glyph for the checked state;
- SvgImageGrayed — Gets or sets a vector glyph for the indeterminate state;
- SvgImageSize — Gets or sets the size of vector glyphs. The default size is 18x18 pixels on a 100% DPI screen;
specify raster glyphs:
- ImageUnchecked — Gets or sets the image for the unchecked state of the check box. (RepositoryItemCheckEdit.PictureUnchecked is equivalent);
- ImageChecked — Gets or sets the image for the checked state of the check box. (RepositoryItemCheckEdit.PictureChecked is equivalent);
- ImageGrayed — Gets or sets the image for the indeterminate state of the check box. (RepositoryItemCheckEdit.PictureGrayed is equivalent);
specify an image collection and use image indexes to specify glyphs:
Images — Gets or sets the collection of images that specify the unchecked, checked and indeterminate states of the check box. (RepositoryItemCheckEdit.Images is equivalent). You can use the following image collections:
- SvgImageCollection — Stores vector icons that can scale without losing their quality on high resolution devices;
- ImageCollection — Supports image transparency;
- SharedImageCollection — Supports image transparency. Allows you to share images between controls within multiple forms;
- SvgImageCollection — Stores vector icons that can scale without losing their quality on high resolution devices;
- ImageList;
- ImageIndexUnchecked — Gets or sets the index of an image in the images collection for the unchecked state of the check box. (RepositoryItemCheckEdit.ImageIndexUnchecked is equivalent);
- ImageIndexChecked — Gets or sets the index of an image in the images collection for the checked state of the check box. (RepositoryItemCheckEdit.ImageIndexChecked is equivalent);
- ImageIndexGrayed — Gets or sets the index of an image in the images collection for the indeterminate state of the check box. (RepositoryItemCheckEdit.ImageIndexGrayed is equivalent);
specify URIs of images in the DX Image Gallery:
- ImageUriUnchecked — Gets or sets an image URI for the unchecked state;
- ImageUriChecked — Gets or sets an image URI for the checked state;
- ImageUriGrayed — Gets or sets an image URI for the indeterminate state;
Tip
You can also enable a predefined vector glyph (e.g., thumb, toggle, heart) that is automatically colored and scaled according to the skin, palette and DPI setting. See RepositoryItemCheckEdit.CheckBoxOptions for details.
