PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Taking focus
  • ScreenFirst used with a window
  • Processes run when using ScreenFirst
  • ScreenFirst, SetFocus and ReturnToCapture
  • Error
  • Subscripted control
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Defines the next control that will be in edit in the current window. This control will have "focus": the actions performed by the user on the keyboard will be applied to this control.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 16 and later
WINDEVLinux This function is now available for the WINDEV applications in Linux.
New in version 16
WINDEVLinux This function is now available for the WINDEV applications in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
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 Name> [, <Subscript>]])
<Control Name>: Optional character string (with or without quotes)
Name of control (including table column) or window that will be in edit.
If this parameter corresponds to the name of a window, the window will be activated and a control that can take focus will be in edit.
If this parameter corresponds to a control that cannot take focus (invisible control, static control, and so on), the input will start from the next control according to the tab order.
<Subscript>: Optional integer
Subscript for a subscripted control.
LinuxAndroidiPhone/iPadWindows MobileJava This parameter is not available.
Remarks

Taking focus

When a control takes 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 (buttons, list boxes, radio buttons, and so on.).
Caution: Some types of controls cannot take focus ("Static" controls for example).

ScreenFirst used with a window

If <Control Name> corresponds to the name of a window, the window is activated. The control that will take focus in this window will correspond to:
  • the last control previously in edit in this window,
  • the first control that can take focus in this window (if no input was previously performed in this window).

Processes run when using ScreenFirst

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

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 the next control that will be in edit (when the current code stops and when the input resumes).
  • SetFocus stops the current process, describes the next control that will be in edit and resumes the current process.

Error

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

Subscripted control

<Subscript> enables you to specify the subscript of a subscripted control. You can also use the name of the subscripted control. For example:
ScreenFirst(EDT_Edit1, 1) = ScreenFirst(EDT_Edit1[1])
Components
WINDEVReports and Queries wd230obj.dll
Windows Mobile wp230obj.dll
Java wd230java.jar
Linux wd230obj.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment