Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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

Delphi
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.

See Also