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.GetInfoForCompare(TcxDataRecordHandle,TcxDataItemHandle,PAnsiChar) Method

Locates data in memory for a specific record/column.

#Declaration

Delphi
function GetInfoForCompare(ARecordHandle: TcxDataRecordHandle; AItemHandle: TcxDataItemHandle; var PValueBuffer: PAnsiChar): Boolean; virtual;

#Parameters

Name Type
ARecordHandle TcxDataRecordHandle
AItemHandle TcxDataItemHandle
PValueBuffer PAnsiChar

#Returns

Type
Boolean

#Remarks

The GetInfoForCompare method allows you to implement a faster comparison operation for values in a custom data source. In this instance, you must also override the IsNativeCompare function which returns True.

The ARecordHandle parameter identifies the record handle (a unique identifier of a record) in the current data source. The AItemHandle parameter determines the item handle (a value that uniquely identifies the column and thus the field from which to return the text to display). See the TcxCustomDataSource class to obtain detailed information on record and item handles.

Before calling GetInfoForCompare, the GetRecordHandleByIndex and GetItemHandle methods are invoked. They return the record handle and the item handle respectively which are passed as arguments to the GetInfoForCompare method.

The GetInfoForCompare method returns the pointer in memory at which the value for a specific record/column is located. The comparison procedure determines the type of values to compare by reading the TcxGridColumn.DataBinding.ValueTypeClass property.

The function returns True if the pointer to a specific value is located. Otherwise, it returns False.

See Also