TileView.ItemCustomize Event

Allows you to customize individual tiles.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v20.1.dll

Declaration

[DXCategory("Data")]
public event TileViewItemCustomizeEventHandler ItemCustomize
<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.

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);
    //...
}

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.

See Also