|The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....|
|Home BasePack DStruct Class TStringArray Methods FindCellInSortedColumn|
|See also: FindCell, Elem, SortOrder, Sort, Unsort, CommitSorting|
The method FindCellInSortedColumn searches for the occurrence of the string FindStr in the sorted column ColIdx. The parameter ColIsAscending indicates the sort order of the column elements (TRUE = ascending, FALSE = descending). The parameter MatchCase determines whether upper and lower cases are ignored (FALSE) or used (TRUE) during the search. The parameters RowLow and RowHigh define the search range. The valid range for ColIx is 0..NrOfColumns, and for RowLow and RowHigh is 1..NrOfRows. In order to include an entire column into the search range, the values for RowLow and RowHigh have both to be set to a value of -1.
If the search is successful FindCellInSortedColumn returns TRUE. In this case the variable parameter Row contains the coordinates of the found string. If the search string has not been found, the parameter Row points to the row above or below the string which comes closest to the search string.