<Window/Page>.ToSource (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

WEBDEV

WINDEV Mobile

Others

See also

<Window/Page>.ToSource (Function)

In french: <Fenêtre/Page>.VersSource

Not 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 data file items bound to the window or page 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 of the controls found in the window or in the page. The WLanguage variables bound to the window or page controls are automatically updated with the values of these controls (even if they are grayed, inactive or invisible).

Only the binding to the items of a data file is supported. The binding to WLanguage variables is not supported in this version.

Remarks:

<Window/Page>.ToSource cannot be used to write to the data file: only the variables of the data file items are bound (i.e variables of the record loaded in memory). To modify the records, you must use <Source>.Add, <Source>.Modify, <Source>.Write, ...
In WEBDEV, you also have the ability to use <Page>.ToSource.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 18 and later

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available for iPhone/iPad applications.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 22 and later

This function is now available in Universal Windows 10 App mode.

This function is now available for Android applications.

This function is now available for Java applications.

New in version 22

This function is now available in Universal Windows 10 App mode.

This function is now available for Android applications.

This function is now available for Java applications.

This function is now available in Universal Windows 10 App mode.

This function is now available for Android applications.

This function is now available for Java applications.

Example

// Click the "Add" button
WIN_Customer.ToSource()
HAdd(Customer)
IF HErrorDuplicates() = True THEN Error("This number already exists")

Syntax

<Window/Page>.ToSource([<Source>])

<Window/Page>: Name of window or page

Name of the window or page where the controls are found.
If this parameter is not specified or is an empty string (""), the window/page of the current code is used.

<Source>: 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 controls that have a binding to this data file are taken into account.
The name of a WLanguage variable: only controls that have a binding to this 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 content of the variable (e.g., a variable containing the name of another variable).
If this name is not specified, all the window/page controls bound to a data file described in the data model editor or with 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).
In the code, with the DataBinding property.

Updating the items: Special cases

To automatically assign the NULL value to an item with <Window/Page>.ToSource:
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 bound to a control are not updated by <Window/Page>.ToSource.
If multiple controls in the window/page are bound to the same data file item, <Window/Page>.ToSource 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.
<Window/Page>.ToSource does not bind Image controls to items or variables. Use <Source>.LinkMemo.
<Window/Page>.ToSource does not operate with the views.

Component: wd260obj.dll