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.v23.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

public int GetChildRowHandle(
    int rowHandle,
    int childIndex
)

VB.NET

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.

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the GetChildRowHandle(Int32, Int32) method.

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-reorder-tileview-cards-sql/CS/Reorder/Form1.cs#L35

for(int n = 0; n < childRowCount; n++) {
    int rowHandle = view.GetChildRowHandle(e.NewGroupRowHandle, n);
    // Skip the TargetIndexInGroup - this index must belong to the dragged card

VB.NET

winforms-grid-reorder-tileview-cards-sql/VB/Reorder/Form1.vb#L32

For n As Integer = 0 To childRowCount - 1
    Dim rowHandle As Integer = view.GetChildRowHandle(e.NewGroupRowHandle, n)
    ' Skip the TargetIndexInGroup - this index must belong to the dragged card