SetFocus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Control functions

Focus gain
ScreenFirst, SetFocus and SetFocusAndReturnToUserInput
SetFocus on a Table control column
SetFocus on the current control
SetFocus on the last selected control
Processes executed when SetFocus is called

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SetFocus (Function)

In french: DonneFocus

Set focus:

to a control (in a window, in a page or in a frameset).
a window.

Example

// Set focus on the EDT_Edit1 control
SetFocus(EDT_Edit1)

// Set focus on the EDT_Edit1 control in
// the "Registration" page or window
SetFocus(Registration.EDT_Edit1)

// Set focus on MyControl
// found in the LOOP_Customer Looper control.
// Select the second row
LOOP_Customer = 2
SetFocus(LOOP_Customer.MyControl)

Syntax

Setting the focus on a control in the current window or page Hide the details

SetFocus([<Control name>])

<Control name>: Optional control name

Name of control (or column) that will gain focus (see "Remarks"). If this parameter is not specified, the current control gains focus.
A WLanguage error occurs if <Control name> does not correspond to a control found in the current window or in the current page.
No focus can be set on an Image control.

Name of the control that must gain focus (see "Remarks"). If this parameter is not specified, a compilation error appears. If this parameter is a constructed string (e.g.: "Field" + sNumChamp), no verification of the field's existence is performed (if the specified field doesn't exist, a Javascript error will appear in the browser).

Setting the focus on a control in a page of the current frameset (Internet Explorer only) Hide the details

SetFocus([<Control in the page>])

<Control in the page>: Character string

Name of the control that will gain focus in the page. This parameter has the following format:
<Page name>.<Control name>
where:
<Page name> is the name of the page containing the control that will gain focus.
<Control name> is the name of the control that will gain focus. If this parameter is a constructed string (e.g.: "Field" + sNumChamp), no verification of the field's existence is performed (if the specified field doesn't exist, a Javascript error will appear in the browser).

Setting the focus to a window Hide the details

SetFocus([<Window>])

<Window>: Optional window name

Name of the window that will gain focus. This window will be enabled and the control gaining focus in this window will correspond to:
the last control previously in edit in this window.
the first control that can gain focus in this window (if no data was previously entered).
If this parameter is not specified, the current control gains focus.

Remarks

Focus gain

Taking "focus" is represented in different ways:

Blinking cursor (or "Caret") for the edit controls.
Dotted rectangle for the other types of controls (Buttons, List Boxes, Radio Buttons, etc.).

Caution: Not all field types can take focus ("label" type fields, for example).

ScreenFirst, SetFocus and SetFocusAndReturnToUserInput

These functions have a different behavior:

SetFocusAndReturnToUserInput stops the current process to force the input in the specified control.
ScreenFirst defines which control will receive input focus (when the current code stops and input focus is set back to a control).
SetFocus stops the current process, defines which control will receive input focus and resumes the current process.

SetFocus on a Table control column

SetFocus sets the focus on the specified column. If the Table control is not receiving any input, it becomes editable.

SetFocus on the current control

SetFocus used without parameters sets the focus on the current control. This function, called in the exit code of an Edit control, is used to force the input in the selected control if the data entered and the expected data do not match.

SetFocus on the last selected control

The control type must be:

edit control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
Click Area control.

Processes executed when SetFocus is called

In most cases, the exit process (from the current control or window) and the entry process (in the specified control or window) are executed when SetFocus is called.

Exceptions:

No code is executed if <Nom du champ> is the current field.
The exit code of the selected control is not executed if SetFocus is used in one of the WLanguage events associated with this control.

Business / UI classification: UI Code

Component: wd300obj.dll