CGrid:TH_FindCol


The TH_FindCol method returns the column number containing the specified string. By default, the search is performed in the first top heading row at index 0. You can also search another top heading at a row index below 0, namely, -1, -2, etc., or the grid body starting at row 1.

Note: The top heading row numbering differs with the CGridView class. Moving upward from the grid, the CGrid top headings are numbered 1, 2, 3, ..., whereas the CGridView top headings are numbered 0, -1, -2, ...

Syntax

nColumn = CGrid:TH_FindCol( strName )

nColumn = CGrid:TH_FindCol( strName, nHdgRow )

bullet.gif    Where strName is the string to locate.

bullet.gif    Optionally, nHdgRow specifies a different top heading row to search. If this is omitted, only row 0 is searched.

bullet.gif    nColumn is returned as the index of the column found, starting with 1. On error, -10 is returned, as it is unlikely a grid has more than 10 side columns.

Example

The following creates a CGrid, fills it with data, then finds a named column:

G = new_grid()

-- create a new CGrid object

-- fill the grid

 

nCol = G:TH_FindCol("x center")

-- returns the column with top heading "x center".

Related Topics

CGrid class, Get, SH_FindRow, FindCell

 


Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All Rights Reserved.