PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Binding between a control and a WLanguage variable or between a control and an item of a data file
  • Updating the items: Special cases
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
Automatically updates:
  • the memory value of the items in a data file with the value from the controls in the window or page. The data file items bound to the window controls are automatically updated with the values of these controls (even if they are grayed, inactive or invisible).
  • the value of the WLanguage variables with the value from the controls in the window or page. The WLanguage variables bound to the window controls are automatically updated with the values of these controls (even if they are grayed, inactive or invisible).
PHP Only the binding to the items of a data file is supported. Bindings to WLanguage variables are not supported in this version.
Versions 15 and later
Android This function is now available for Android applications.
New in version 15
Android This function is now available for Android applications.
Android This function is now available for Android applications.
Versions 16 and later
Linux This function is now available for WINDEV applications in Linux.
New in version 16
Linux This function is now available for WINDEV applications in Linux.
Linux This function is now available for WINDEV applications in Linux.
Versions 17 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for iPhone/iPad applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Android Widget This function is now available in Android widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Remarks:
  • The ScreenToFile function does not allow writing to the data file: the variables of the data file items can only be updated (i.e variables of the record loaded in memory). To modify the records, you must use HAdd, HModify, HWrite, etc.
  • In WEBDEV it is also possible to use the PageToFile function.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
Example
// Clic sur le bouton "Ajouter"
ScreenToFile()
HAdd(Client)
IF HErrorDuplicates() = True THEN
Error("Ce numéro existe déjà")
END
Syntax
ScreenToFile([<Window/Page> [, <Source>]])
<Window/Page>: Name of window or page
Name of the window or page that contains the controls. If this parameter is not specified or is an empty string (""), the window/page of the current code is used.
PHP If this parameter is specified, it must correspond to the name of the current page. Otherwise, an error occurs.
AndroidAndroid Widget Java If this parameter is specified, it must correspond to the name of the current window. Otherwise, an error occurs.
<Source>: Optional character string
Name of the source containing the data to update. This source can be:
  • The name of a data file: only the controls bound to the items of the data file are taken into account.
  • The name of a WLanguage variable: only the controls bound to the WLanguage variable are taken into account.
    Remarks:
    • If the name of the variable is enclosed in quotes, the control will be bound to the specified variable.
    • If the name of the variable is not enclosed in quotes, the control will be bound to the variable data (e.g., a variable containing the name of another variable).
If this name is not specified, all the window or page controls that are bound to a data file described in the data model editor or to a WLanguage variable will be taken into account.
Remarks

Binding between a control and a WLanguage variable or between a control and an item of a data file

The binding between a control and a WLanguage variable or between a control and an item of a data file can be determined:
  • In the editor, in the control description window ("Binding" tab).
  • Programmatically, with the DataBinding property.

Updating the items: Special cases

  • To automatically assign the value NULL to a field with function ScreenToFile:
    1. Check "NULL supported" for the item in the data model editor.
    2. Select the "NULL if empty" option in the Edit control bound to the item.
  • The items of the data file that are not bound to a control are not updated by ScreenToFile.
  • If multiple controls in the window/page are bound to the same data file item, ScreenToFile may not update the bound item properly. It is not recommended to bind multiple controls in a window/page to the same item of a data file.
  • ScreenToFile does not update the items with the values from Image controls. Use HLinkMemo.
  • ScreenToFile is not available on views.
Component: wd270obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment