| |
CGridView:FindRow
The FindRow method returns the row number containing the specified string. The row names are matched to the target name by ignoring differences in case, so that matching to the target string "mag", "Mag", or "MAG" will give the same result. By default, the search is performed in the first left heading column at index 0. You can also search another left heading at column index -1, -2, etc., or the grid body starting at column 1.
This method strips leading and trailing whitespace from the grid's row title before comparing to the target name. To find a row by matching the exact name in the grid (wihout matching the case), use FindRow2. For example, suppose you wish to find the grid row with the title "Mag". If the grid title is "Mag " or " Mag", then the present function finds the match because it ignores the leading whitespace in " Mag" and the trailing whitespace in "Mag ". However, the FindRow2 method does not find a match and returns -10.
nRow = CGridView:FindRow( strName )
nRow = CGridView:FindRow( strName, nCol )
Where strName is the string to locate.
Optionally, nCol specifies a different column to search. If
this is omitted, only column 0 (the first side-heading column) is
searched.
nRow is
returned as the index of the row found. On error, -10 is returned,
as it is unlikely a grid has more than 10 top rows.
The following script attaches a grid window and finds a named row:
|
|
-- attaches the top-most grid window from Mira |
|
|
-- returns the row with side heading "my row title". |
Mira Pro x64 Script User's Guide, v.8.73 Copyright Ⓒ 2024
Mirametrics, Inc. All Rights Reserved.