Identifying Rows

• May 22, 2020
• 2 minutes to read

Identifying Rows

Rows in views are identified by unique integer values - row handles. A View associates its rows with row handles using the following rules.

• Each row has a row handle that uniquely identifies it, regardless of whether a row is currently visible (a row might not be visible due to scrolling and it can also be hidden within collapsed groups).
• Data row handles start from zero.
• Group row handles are negative, starting from -1.

Visible rows can also be identified by their visible indices. These indexes start from zero. Successive integers are assigned to additional visible rows (group or data). A row is hidden if it is contained within a collapsed group row.

The image below illustrates assignment rules, along with the relationship between row handles and visible indices.

For information on how to obtain row identifiers, please see Obtaining Row Handles.

Special Row Handles

Row	Description
New Item Row	This row allows an end-user to add new records to a data source. Its handle is returned by the DataControlBase.NewItemRowHandle property.
Automatic Filter Row	The Auto Filter Row allows an end-user to filter data on the fly. Typing text within this row automatically creates and applies a filter to a View. Its handle is returned by the DataControlBase.AutoFilterRowHandle property.
Invalid Row	Generally, this row handle corresponds to a row that doesn't exist in a View. Its handle is returned by the DataControlBase.InvalidRowHandle property.