TileViewColumns.BackgroundImageColumn Property

Gets or sets the column that contains images to display in tiles’ background.

Namespace: DevExpress.XtraGrid.Columns

Assembly: DevExpress.XtraGrid.v24.2.dll

Declaration

C#

[DefaultValue(null)]
public GridColumn BackgroundImageColumn { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property BackgroundImageColumn As GridColumn

Property Value

Type	Default	Description
GridColumn	null	A GridColumn object representing the column that contains images to display in tiles’ background.

Remarks

If you want to set images from a specific grid column as tile background images, you can either create an element that corresponds to this column and set appropriate values for this element’s TileItemElement.ImageScaleMode and TileItemElement.ImageAlignment properties, or assign this column to the BackgroundImageColumn property. The advantage of the second approach is that images set as tile background images can stretch over the entire tile, ignoring its padding. To do the same with elements, explicitly set tile paddings to 0, 0, 0, 0.

To arrange background images or modify their scale mode, use the TileViewItemOptions.ItemBackgroundImageAlignment or TileViewItemOptions.ItemBackgroundImageScaleMode properties respectively.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the BackgroundImageColumn 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.

C#

winforms-grid-tileview-thumbnails-async-load/CS/TileView-ManualThumbs/Form1.cs#L28

// Specify a column that provides information on images to render.
tileView1.ColumnSet.BackgroundImageColumn = colName;
tileView1.OptionsImageLoad.RandomShow = true;

VB.NET

winforms-grid-tileview-thumbnails-async-load/VB/TileView-ManualThumbs/Form1.vb#L25

' Specify a column that provides information on images to render.
tileView1.ColumnSet.BackgroundImageColumn = colName
tileView1.OptionsImageLoad.RandomShow = True