TileView.ItemCustomize Event

Allows you to customize individual tiles.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v20.2.dll

NuGet Package: DevExpress.Win.Grid

Declaration

C#

[DXCategory("Data")]
public event TileViewItemCustomizeEventHandler ItemCustomize

VB.NET

<DXCategory("Data")>
Public Event ItemCustomize As TileViewItemCustomizeEventHandler

Event Data

The ItemCustomize event's data class is TileViewItemCustomizeEventArgs. The following properties provide information specific to this event:

Property	Description
Item	Gets the currently processed tile.
RowHandle	Gets the row handle of the currently processed tile.

Remarks

By default, all tiles are generated from the default tile template (TileView.TileTemplate). If you need to customize the contents of individual tiles, handle the ItemCustomize event.

The following example handles the ItemCustomize event to hide images for specific tile elements. See the complete example in the Tile View Kanban Board module in the XtraGrid MainDemo.

C#

using DevExpress.XtraEditors;

private void tileView1_ItemCustomize(object sender, DevExpress.XtraGrid.Views.Tile.TileViewItemCustomizeEventArgs e) {
    //...
    var elDescription = e.Item.GetElementByName("Description");
    elDescription.ImageVisible = !string.IsNullOrEmpty(task.Description);
    //...
}

VB.NET

Imports DevExpress.XtraEditors

Private Sub tileView1_ItemCustomize(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Tile.TileViewItemCustomizeEventArgs) _
    Handles tileView1.ItemCustomize
    '...
    Dim elDescription = e.Item.GetElementByName("Description")
    elDescription.ImageVisible = Not String.IsNullOrEmpty(task.Description)
    '...
End Sub

Instead of customizing the contents of tiles, you can supply custom templates for them by handling the TileView.CustomItemTemplate event.

See the Customizing Individual Tiles section of the Tile View topic to learn more.