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 the last selected control

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

// Donne le focus au champ SAI_Saisie1
SetFocus(SAI_Saisie1)

// Donne le focus au champ SAI_Saisie1 de 
// la page/fenêtre "Inscription"
SetFocus(Inscription.SAI_Saisie1)

// Donne le focus au champ MonChamp 
// présent dans le champ Zone répétée ZR_Client.
// Sélection de la seconde répétition
ZR_Client = 2
SetFocus(ZR_Client.MonChamp)

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.
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 check is performed on the field's existence (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 check is performed on the field's existence (if the specified field doesn't exist, a Javascript error will appear in the browser).

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.).

Please note Not all field types (e.g. "label" fields) can take focus.

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 the last selected 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.

The control type must be:

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

Business / UI classification: UI Code

Component: wd300obj.dll