ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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 used with a window
  • Events executed when ScreenFirst is used
  • ScreenFirst, SetFocus and SetFocusAndReturnToUserInput
  • Error
  • Indexed control
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Defines the next control that will be in edit in the current window. This field will have "focus": keyboard actions performed by the user will be directed to this field.
Example
// Puts the input on the "EDT_Edit2" control
ScreenFirst(EDT_Edit2)
// Changes the next control in edit
IF ControlCurrent() <> EDT_Name THEN ScreenFirst(EDT_Name)
Syntax
ScreenFirst([<Control used> [, <Index>]])
<Control used>: Optional control name
Name of control (including columns of a Table control) or window that will be in edit mode.
If this parameter corresponds to the name of a window, the window will be activated and a control that can gain focus will be in edit.
If this parameter corresponds to a control that cannot gain focus (invisible control, static control, and so on), the input will start from the next control according to the tab order.
<Index>: Optional integer
Index for an indexed control.
LinuxAndroidiPhone/iPadIOS WidgetMac CatalystJava This parameter is not available.
Remarks

Focus gain

When a control gains focus, this is indicated in different ways depending on the type of the control:
  • Blinking cursor (or "Caret") for the edit controls.
  • Dotted rectangle for the other types of controls (Button, List Box, Radio Button controls, etc.).
Caution: Not all field types can take focus ("Label" type fields, for example).

ScreenFirst used with a window

If <Control name> corresponds to the name of a window, the window becomes active. The control that will gain 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).

Events executed when ScreenFirst is used

In most cases, exit events (from the current control or window) and entry events (in the specified control or window) are run when ScreenFirst is called.
Exception to this rule: The exit code of the current field is not executed if the ScreenFirst function is used in one of the events associated with this field.

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.

Error

A WLanguage error occurs if <Control name> does not correspond to a control in the current window.
WINDEVReports and QueriesWindowsUser code (UMC)

Indexed control

<Index> allows you to specify the index of an indexed control. You can also use the name of the indexed control. For example:
ScreenFirst(EDT_Edit1, 1) = ScreenFirst(EDT_Edit1[1])
Component: wd300obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/30/2024

Send a report | Local help