TcxCustomDataController.GetRowInfo(Integer) Method

Returns an object containing information on a particular row.

Declaration

function GetRowInfo(ARowIndex: Integer): TcxRowInfo;

Parameters

Name	Type
ARowIndex	Integer

Returns

Type
TcxRowInfo

Remarks

The GetRowInfo function returns a TcxRowInfo structure containing information on a row (a potentially visible data record or a grouping row) at a particular position. The row is addressed by the ARowIndex parameter, which also specifies its position within the data controller. The total number of rows is determined by the RowCount property. For more information on row indexes, see the TcxCustomDataController description.

The RowInfo object returned by the function describes the row’s record index, its group level and expansion state.

Several functions (for instance, GetRowDisplayText and GetRowValue) require the RowInfo object.

The following example tests whether a specific row is a grouping row:

Delphi

function IsGroupingRow(ARowInfo: TcxRowInfo; ADataController: TcxCustomDataController): Boolean;
begin
  with ADataController do
    Result := ARowInfo.Level <> Groups.GroupingItemCount;
end;

C++

bool IsGroupingRow(const TcxRowInfo & ARowInfo, TcxCustomDataController * ADataController) {
  return ARowInfo.Level != ADataController->Groups-> GroupingItemCount;
}