TileView.GetChildRowHandle(Int32, Int32) Method

Returns a unique identifier of the tile at the specified position in the group with the specified handle.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v20.2.dll

Declaration

public int GetChildRowHandle(
    int rowHandle,
    int childIndex
)
Public Function GetChildRowHandle(
    rowHandle As Integer,
    childIndex As Integer
) As Integer

Parameters

Name Type Description
rowHandle Int32

An integer value that specifies a unique identifier of the group.

childIndex Int32

An integer value that specifies an index of the required tile in the group.

Returns

Type Description
Int32

An integer value that specifies a tile handle.

Remarks

If tiles are grouped using the TileViewColumns.GroupColumn property of the TileView.ColumnSet collection, you can use the TileView.GetParentRowHandle, GetChildRowHandle, TileView.GetChildRowCount and TileView.IsGroupRow methods to operate tiles based on tile handles and groups.

See the Rows topic for more information on tile handles and the Data Grouping section in the Tile View topic for details on the grouping feature.

Examples

The following example shows how to get a handle for the group to which a particular tile belongs, and iterate visible tiles in this group.

// Get a handle of the group to which a particular tile belongs (tile with the 0 handle in this example).
int groupHandle = tileView1.GetParentRowHandle(0);
// Check whether a handle corresponds to a group of tiles.
if (tileView1.IsGroupRow(groupHandle)) {
    // Get the number of tiles in the group.
    int groupTileCount = tileView1.GetChildRowCount(groupHandle);
    for (int i = 0; i < groupTileCount; i++) {
        // Get a handle for the tile  with the current index in the group.
        int childRowHandle = tileView1.GetChildRowHandle(groupHandle, i);
        // Check whether the tile is visible.
        if (tileView1.IsTileVisible(childRowHandle) == DevExpress.XtraGrid.Views.Grid.RowVisibleState.Visible) {
            // Get an underlying data object (DataRowView in this case), and perform the required actions.
            var row = tileView1.GetRow(childRowHandle) as System.Data.DataRowView;
            // ...
        }
    }
}
See Also