<Table>.SetFocus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Table>.SetFocus (Function)

In french: <Table>.DonneFocus

Gives focus to a row found in a Table or TreeView Table control: the control switches to edit for the specified row and column.

Example

// Add a row and switch to edit on "New" (COL_Name column)
let nRow = TABLE_MyTable.AddLine("New", 2)
TABLE_MyTable.SetFocus(nRow, COL_Nom)

Syntax

<Result> = <Table control>.SetFocus([<Subscript> [, <Column>]])

<Result>: Boolean

True if the Table control is switched to edit,
False otherwise.

<Table control>: Control name

Name of Table control to use. This control can correspond to:
a Table control.
a TreeView Table control.

<Subscript>: Optional integer

Subscript of the row that will take focus.
If this parameter is not specified, the focus is given to the current row. If there is no current row, <Table>.SetFocus has no effect and it returns False.

<Column>: Control name

Name of table column that will take 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), <Table>.SetFocus has no effect and returns False.

Remarks

If the Table control does not have focus, <Table>.SetFocus gives focus to the control.
If the Table control is grayed or inactive, <Table>.SetFocus has no effect and it returns False.
The processes for entering or exiting controls, rows and columns are NOT run.
If the Table control already is in edit, the number of the row or column in edit is modified.
The rows displayed in the Table control may be moved in order for the row with new focus to be visible.

Component: wd260obj.dll