- Binding between a control and a WLanguage variable or between a control and an item of a data file
- Updating the items: Special cases
ScreenToSource (Function) In french: EcranVersSource
 Not available with this kind of connection
Automatically initializes: - 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 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 from the controls in the window or 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).
Remarks: - ScreenToSource cannot be used to write 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 HWrite, HAdd, HModify, etc.
- In WEBDEV, you can also use PageToSource.
// Click the "Add" button
ScreenToSource()
HAdd(Customer)
IF HErrorDuplicates() = True THEN Error("This number already exists")
Syntax
ScreenToSource([<Window/Page> [, <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 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/page controls 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 NULL value to an item with ScreenToSource:
- Check "NULL supported" for the item in the data model editor.
- 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 ScreenToSource.
- If multiple controls in the window/page are bound to the same data file item, ScreenToSource 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.
- ScreenToSource does not update items or variables with the values from Image controls. Use the HLinkMemo function.
- ScreenToSource is not available on views.
- Binding with "Secure Password" items: The value of the "Password" item cannot be modified until the user changes the value in the control bound to the item.
This page is also available for…
|
|
|
|