TileView.GetParentRowHandle(Int32) Method

Returns the unique identifier of the group to which the tile with the specified identifier belongs.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

public int GetParentRowHandle(
    int rowHandle
)

VB.NET

Public Function GetParentRowHandle(
    rowHandle As Integer
) As Integer

Parameters

Name	Type	Description
rowHandle	Int32	An integer value that specifies a handle of the tile for which to return the group handle.

Returns

Type	Description
Int32	An integer value that specifies the unique identifier of the group to which the tile with the specified rowHandle belongs.

Remarks

If tiles are grouped using the TileViewColumns.GroupColumn property of the TileView.ColumnSet collection, you can use the GetParentRowHandle, TileView.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.

Example

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.

C#

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

VB.NET

' Get a handle of the group to which a particular tile belongs (tile with the 0 handle in this example).
Dim groupHandle As Integer = TileView1.GetParentRowHandle(0)
' Check whether a handle corresponds to a group of tiles.
If TileView1.IsGroupRow(groupHandle) Then
    ' Get the number of tiles in the group.
    Dim groupTileCount As Integer = TileView1.GetChildRowCount(groupHandle)
    For i As Integer = 0 To groupTileCount Step 1
        ' Get a handle for the tile  with the current index in the group.
        Dim childRowHandle As Integer = TileView1.GetChildRowHandle(groupHandle, i)
        ' Check whether the tile is visible.
        If TileView1.IsTileVisible(childRowHandle) = DevExpress.XtraGrid.Views.Grid.RowVisibleState.Visible Then
            ' Get an underlying data object (DataRowView in this case), and perform the required actions.
            Dim row = TryCast(TileView1.GetRow(childRowHandle), System.Data.DataRowView)
            ' ...
        End If
    Next
End If