ReturnToCapture (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 ReturnToCapture
Error
ReturnToCapture on the last selected control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ReturnToCapture (Function)

In french: RepriseSaisie

Not available

Stops the current process and forces the input in the specified control, window or page.

ReturnToCapture can be used in a browser event (onchange, onclick, etc.), but it cannot be used in a local procedure or a global browser procedure.

Note: This function is equivalent to SetFocusAndReturnToUserInput.

Example

// Si l'utilisateur n'a rien saisi dans le champ
IF SAI_Saisie1 = "" THEN
	// On affiche un message et on remet l'utilisateur en saisie sur le champ 
	Error("Saisissez une valeur")
	ReturnToCapture(SAI_Saisie1)
END

Syntax

SetFocusAndReturnToUserInput([<Element to handle>])

<Element to handle>: Control, window or page name

Name of control, column or window that will gain focus (see Notes). If this parameter is not specified, the current control gains focus.
To specify a control that belongs to a window other than the current window, <Element to handle> must be in the following format: <Window name>.<Control name>.
Name of the control or page that will gain focus (see Notes). If this parameter is not specified, the last 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 (Button, List Box, Radio Button controls, etc.).

ScreenFirst, SetFocus and ReturnToCapture

These functions have a different behavior:

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

Error

A WLanguage error occurs if <Element to handle> does not correspond to a control in the current window or page.

ReturnToCapture on the last selected control

ReturnToCapture 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 must be one of the following types of controls:

Edit control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
"Clickable area" Image control.

If the name of the control corresponds to a string that is built, the alias of the control must be used ("ControlAlias"+Num for example). In this case, no verification is performed: Javascript errors may be displayed if the focus is given to a field that doesn't exist.

Reminder: The alias of a field corresponds to the name of this field in the HTML page.. To find out this alias:

in the code editor, press Shift + F1.
use the Alias property.

Business / UI classification: UI Code

Component: wd300obj.dll