ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Set focus:
  • to a control (found 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.
AndroidJava No focus can be set on an Image control.
WEBDEV - Browser code 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 built string (for example: "Control" + sControlNum), no check regarding the existence of the control is performed (a JavaScript error will be displayed in the browser if the specified control does not exist).
WEBDEV - Browser code

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 built string (for example: "Control" + sControlNum), no check regarding the existence of the control is performed (a JavaScript error will be displayed in the browser if the specified control does not exist).
WINDEVReports and QueriesAndroidiPhone/iPadIOS WidgetMac CatalystJavaUser code (UMC)

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: Some types of controls cannot take focus ("static" controls 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.
WINDEVReports and QueriesJavaUser code (UMC)

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.
WINDEVReports and QueriesAndroidiPhone/iPadIOS WidgetMac CatalystJavaUser code (UMC)

SetFocus on the current control

SetFocus used without parameters sets the focus on the current control. This function, called in the exit code of edit control, is used to force the input in the selected control if the information typed does not correspond to the expected information.
Windows

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 edit control, is used to force the input in the selected control if the information typed does not correspond to the expected information.
The control type must be:
  • edit control.
  • Check Box control.
  • Radio Button control.
  • List Box control.
  • Combo Box control.
  • Click Area control.
WINDEVReports and QueriesAndroidiPhone/iPadIOS WidgetMac CatalystJavaUser code (UMC)

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 run if <Control name> is the current control.
  • 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
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help