TcxCustomDataSource.GetRecordHandle(Integer) Method

Returns the record handle for a specific record’s index before the data controller retrieves data from the data source for the first time.

Declaration

function GetRecordHandle(ARecordIndex: Integer): TcxDataRecordHandle; virtual;

Parameters

Name	Type
ARecordIndex	Integer

Returns

Type
TcxDataRecordHandle

Remarks

By default, the GetRecordHandle method retrieves the same value as the ARecordIndex parameter. The GetRecordHandle method is called for every record in the data source before the data controller retrieves data from it. The number of records is determined by the GetRecordCount function. See the TcxCustomDataSource class to learn more about record indexes and handles.

Record handles retrieved by this method are stored in an internal array along with record indexes. When displaying data, record handles are retrieved from this array for specific record indexes by the GetRecordHandleByIndex method.