PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Link 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
ScreenToFile (Function)
In French: EcranVersFichier
ODBCNot available with this kind of connection
Automatically initializes:
  • the memory value of the items of a data file with the value of the controls found in the window or in the page. The items of the base data file linked to the window controls are automatically assigned with the values of the corresponding controls (even if these controls are grayed, inactive or invisible).
  • the value of the WLanguage variables with the value of the controls found in the window or in the page. The WLanguage variables linked to the window controls are automatically assigned with the values of the corresponding controls (event if these controls are grayed, inactive or invisible).
AndroidAndroid Widget JavaPHP Only the link with the items of a data file is supported. The link with the WLanguage variables is not supported in this version.
PHP Only the link with the items of a data file is supported. The link with the WLanguage variables is not supported in this version.
Versions 22 and later
AndroidAndroid Widget From version 22, the link with the WLanguage variables is supported.
New in version 22
AndroidAndroid Widget From version 22, the link with the WLanguage variables is supported.
AndroidAndroid Widget From version 22, the link with the WLanguage variables is supported.
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
Linux This function is now available for the WINDEV applications in Linux.
New in version 16
Linux This function is now available for the WINDEV applications in Linux.
Linux 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.
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.
Notes:
  • ScreenToFile cannot be used to write into the data file: Only the variables of the file items are assigned (which means the variables of the record loaded in memory). To modify the records, you must use HAdd, HModify, HWrite, ...
  • In WEBDEV, you also have the ability to use PageToFile.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
Example
// Click the "Add" button
ScreenToFile()
HAdd(Customer)
IF HErrorDuplicates() = True THEN
Error("This number already exists")
END
Syntax
ScreenToFile([<Window Name> [, <Source Name>]])
<Window Name>: Optional character string (with or without quotes)
Name of the window or page where the controls are found. If this parameter is not specified or if it corresponds to an empty string (""), the window or the page to which the current code belongs will be 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 Name>: Optional character string (with or without quotes)
Name of the source containing the data to update. This source can be:
  • The name of a data file: only the controls that have a link with this data file are taken into account.
  • The name of a WLanguage variable: only the controls that have a link with this WLanguage variable are taken into account.
    Notes:
    • If the name of the variable is enclosed in quotes, the link will be performed with the specified variable.
    • If the name of the variable is not enclosed in quotes, the link will be performed with the content of the variable (variable containing the name of another variable for example).
If this name is not specified, all the window/page controls that have a link with a data file described in the data model editor or with a WLanguage variable will be taken into account.
Remarks

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

The link between a control and a WLanguage variable or between a control and an item of a data file can be known:
  • In the editor, in the description window of the control ("Link" tab).
  • By programming, with ..Filelink.

Updating the items: Special cases

  • To automatically assign the NULL value to an item with ScreenToFile:
    1. Check "NULL supported" for the item in the data model editor.
    2. Select the "NULL if empty" option in the edit control associated with the item.
  • The items of the data file that are not linked to a control are not updated by ScreenToFile.
  • If several window/page controls are linked to the same data file item, the linked item may not be updated properly by ScreenToFile. We do not advise you to link several controls of a window/page to the same item of a data file.
  • ScreenToFile does not assign the items for the image controls. Use HLinkMemo.
  • ScreenToFile does not operate with the views.
Components
WINDEVReports and Queries wd230obj.dll
WEBDEV - Server code wd230page.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