VGridControlBase.HtmlImages Property

Gets or sets a collection of images that can be embedded in row headers and cells using the image tag.

Namespace : DevExpress.XtraVerticalGrid

Assembly : DevExpress.XtraVerticalGrid.v25.2.dll

NuGet Packages : DevExpress.Win.Navigation, DevExpress.Win.VerticalGrid

csharp

[DefaultValue(null)]
public object HtmlImages { get; set; }

<DefaultValue(Nothing)>
Public Property HtmlImages As Object

Property Value

Type	Default	Description
Object	null

An image collection.

Remarks

You can use a set of HTML-inspired tags to format text in row headers and cells.

The BaseOptionsView.AllowHtmlText property activates HTML formatting for row headers. To format cell text with HTML tags, use a RepositoryItemHypertextLabel as an in-place editor.

When you compose an HTML string, you can use the image tag to insert an image from an image collection and project’s resources into the text.

To insert an image from an image collection, do the following:

Create an image collection (ImageCollection or SvgImageCollection) and populate it with images.
Assign the collection to the HtmlImages property. When you display images in cells with RepositoryItemHypertextLabel, you can also assign the created image collection to the RepositoryItemHypertextLabel.HtmlImages property.
When you use the image tag, address a target image by its name (image names can be obtained from the image collection).

See HTML Text Formatting for more information.

Example

The following example shows how to display an image in a Company row header using HTML tags.

C#
VB.NET

csharp

string imageName = "company";
imageCollection1.AddImage(Image.FromFile("c:\\company-16x16.png"), imageName);

vGridControl1.OptionsView.AllowHtmlText = true;
vGridControl1.HtmlImages = imageCollection1;
rowCompanyName.Properties.Caption = "Company <image=" + imageName + ">";

Dim imageName As String = "company"
imageCollection1.AddImage(Image.FromFile("c:\company-16x16.png"), imageName)

vGridControl1.OptionsView.AllowHtmlText = True
vGridControl1.HtmlImages = imageCollection1
rowCompanyName.Properties.Caption = "Company <image=" + imageName + ">"