O4WSetCell routine
Description
Sets the active cell in the table to the row and column location specified.
Syntax
O4WSetCell(rowNum, colNo, id, style)
Parameters
The function has the following parameters:
| Parameter | Description | |
|---|---|---|
| rowNum | The row position to be set. Row positions start at 0 (the column header row). | |
| colNo | The column position to be set. Column positions start at 1 | |
| id | The id of the table. The table can be addressed by the id through style sheets individually. | |
| style | When specified, the style is applied to the table that is generated. Note that style can be either the name of a style (as created by one of the O4W style functions, or as defined in an included style sheet), or it can be the returned value from one of the O4W style functions. |
|
Remarks
If <colnum> and <rownum> are not specified, the next column in the current row will automatically be selected; if only <rownum> is specified, the first column in that row will be selected (NOTE: if any of the cells in the table are styled with "column spanning" or "row spanning" via the O4WTableCellOptions call, you should NOT use the 'implicit' rownum/colno functionality, as the cell position will not be correct).
Any other O4W display or input controls can now be specified, and will be placed in the table at the specified location.
Row and column number parameters also allow the use of relative changes; that is “+<x>” or “-<x>” (ie, “+1” or “-1”) to increment or decrement the current row or column. For example, O4WSetCell(“+1”) will move to the next row.