Gives focus to a row found in a Table or TreeView Table control: the control switches to edit for the specified row and column.
// Add a row and switch to edit on "New" (COL_Name column)
let nRow = TableAddLine(TABLE_MyTable, "New", 2)
TableSetFocus(TABLE_MyTable, nRow, COL_Name)
<Result> = TableSetFocus(<Table control> [, <Subscript> [, <Column>]])
- True if the Table control is switched to edit,
- False otherwise.
<Table control>: Control name
Name of the Table control to be used. This control can correspond to:
- a Table control.
- a TreeView Table control.
<Subscript>: Optional integer
Subscript of the row that will gain focus.
If this parameter is not specified, the focus is given to the current row. If there is no current row, TableSetFocus has no effect and it returns False.
<Column>: Control name
Name of the table column that will receive the focus.
If this parameter is not specified, the focus is given to the first valid column in the display order.
If there is no valid column (or if the column name does not correspond to a column in the Table control), TableSetFocus has no effect and returns False.
- If the Table control does not have focus, TableSetFocus gives focus to the control.
- If the Table control is grayed out or inactive, TableSetFocus has no effect and returns False.
- Control, row and column enter and leave events ARE not executed.
- If the Table control already is in edit mode, the number of the row or column in edit mode is modified.
- The rows displayed in the Table control may be moved in order for the row with new focus to be visible.
Business / UI classification: UI Code