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
  • Link with an item: types of links
  • Various
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
SourceToScreen (Function)
In French: SourceVersEcran
ODBCNot available with this kind of connection
Automatically initializes the controls found in a window or in a page with:
  • the values of the associated items in the current record (loaded in memory) of the HFSQL data file described in the data model editor. This operation is performed regardless of the status of the controls (grayed, inactive or invisible).
  • the values of the associated WLanguage variables. This operation is performed regardless of the status of the controls (grayed, inactive or invisible).
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.
Note: SourceToScreen performs no read operation on the data file. The value of the record loaded in memory is used to initialize the controls. Therefore, a record must be loaded in memory beforehand:
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.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
Versions 22 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 22
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Android This function is now available for the Android applications.
WINDEVJava This function is now available for the Java applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Example
HReadSeekFirst(CUSTOMER, NAME, "PAUL")
IF HFound() = True THEN
SourceToScreen()
END
// Read the record and
// transfer the items to the controls
HReadFirst(CUSTOMER, LASTNAME)
SourceToScreen()
Syntax
SourceToScreen([<Window Name> [, <Source Name>]])
<Window Name>: Optional character string (with or without quotes)
Name of the window or page containing the controls to initialize.
If this parameter is not specified or if it corresponds to an empty string (""), the window to which the current code belongs is used.
PHP If this parameter is specified, it must correspond to the name of the current page. Otherwise, an error occurs.
<Source Name>: Optional character string (with quotes)
Name (between quotes) of the source to which the controls to update are linked. 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 controls that have a link with a data file described in the data model editor or with a WLanguage variable are 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.

Link with an item: types of links

Two types of links can be found between a control and an item:
  • direct link: In this case, SourceToScreen transfers the value of the items found in the record loaded in memory into the linked control, without performing any read operation.
  • link by search in a linked data file.

Various

  • Auto-filled combo boxes linked to a HFSQL data file: SourceToScreen must not be found in the declaration code of the global variables of the window. The function must be used in the initialization code of the window.
  • The space characters found in the in HFSQL items are kept.
  • SourceToScreen assigns the image controls linked to image memo items.
  • SourceToScreen manages the NULL value. If the content of the item corresponds to NULL, an empty string will be displayed in the associated edit control. To modify this display mode, use ControlError.
  • SourceToScreen does not operate with the views. The items must be assigned one by one to the controls.
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 14
This page is also available for…
Comments
Click [Add] to post a comment