TTMSFNCDataGrid.Find Method
Searches the grid for the given text with default parameters and returns the first matching cell.
API unit family: TMSFNCDataGrid
Declaring type: TTMSFNCDataGrid
Inherited from: TTMSFNCCustomDataGrid
Overloads
Overload 1
Searches the grid for the given text with default parameters and returns the first matching cell.
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.
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.
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.