<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 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, <Table>.SetFocus 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), <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 out or inactive, <Table>.SetFocus 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.

Component: wd270obj.dll