Skip to main content
Table of Contents

TTMSFNCCustomDataGrid.Find Method

Searches the grid for the given text with default parameters and returns the first matching cell.

API unit family: TMSFNCDataGrid Declaring type: TTMSFNCCustomDataGrid

Overloads

Overload 1

Searches the grid for the given text with default parameters and returns the first matching cell.

FMX.TMSFNCDataGrid.hppPascalC++
function Find(AText: string): TTMSFNCDataGridCellCoord; overload;

TTMSFNCDataGridCellCoord __fastcall Find(System::UnicodeString AText)/* overload */;

Remarks

Uses an empty parameter set: case-insensitive, fixed cells excluded. Use the overload with AParameters to control matching, direction and scope.

Parameters

Name Description
AText Text to search for.

Returns

The first matching cell, or (-1, -1) when nothing matches.

Overload 2

Searches for text using the specified find parameters, starting at the first (or, backward, last) cell of the search range.

FMX.TMSFNCDataGrid.hppPascalC++
function Find(AText: string; AParameters: TTMSFNCDataGridDataFindParameters): TTMSFNCDataGridCellCoord; overload;

TTMSFNCDataGridCellCoord __fastcall Find(System::UnicodeString AText, TTMSFNCDataGridDataFindParameters AParameters)/* overload */;

Remarks

The text and parameters are remembered, so FindNext can continue the search.

Parameters

Name Description
AText Text to search for.
AParameters Search options controlling case sensitivity, direction and scope (for example including fixed cells or searching only the selection).

Returns

The first matching cell, or (-1, -1) when nothing matches.

Overload 3

Searches for text after a specified cell using the given find parameters.

FMX.TMSFNCDataGrid.hppPascalC++
function Find(AText: string; AParameters: TTMSFNCDataGridDataFindParameters; AStartCell: TTMSFNCDataGridCellCoord): TTMSFNCDataGridCellCoord; overload;

TTMSFNCDataGridCellCoord __fastcall Find(System::UnicodeString AText, TTMSFNCDataGridDataFindParameters AParameters, const TTMSFNCDataGridCellCoord &AStartCell)/* overload */;

Parameters

Name Description
AText Text to search for.
AParameters Search options controlling case sensitivity, direction and scope.
AStartCell Cell after which the search continues; the start cell itself is skipped. Pass (-1, -1) to start at the beginning of the search range.

Returns

The matching cell, or (-1, -1) when nothing matches.