- Binding between a control and a WLanguage variable or between a control and an item of a data file
- Updating the items: Special cases
- Updating data in the Table control (or in Looper controls)
PageToSource (Function) In french: PageVersSource
Not available with this kind of connection
Automatically updates: - the value of the items in a data file with the value of the controls in the page. The basic of the data file fields linked to the Page fields are automatically assigned with the values of the corresponding fields.
- the value of the WLanguage variables with the value of the page controls. The WLanguage variables linked to the Page fields are automatically assigned with the values of the corresponding fields.
This operation is performed regardless of the state of the controls (grayed, inactive or invisible). Remarks: - PageToSource cannot be used to write to the data file: only variables of the data file items are assigned (i.e. variables of the record loaded in memory). To modify the records, you must use HAdd, HModify, HWrite, etc, ...
Only the binging to the items of a data file is supported. Bindings to WLanguage variables are not supported in this version.
// Clic sur BTN_AJOUTER PageToSource() HAdd("Client") IF HErrorDuplicates() = True THEN Error("Ce numéro existe déjà") END
Syntax
PageToSource([<Page> [, <Source>]])
<Page>: Page name Name of the page that contains the controls. If this parameter is not specified or is an empty string (""), the 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 PageToSource:
- 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 PageToSource.
- If multiple controls in the page are bound to the same data file item, PageToSource may not update the bound item properly. It is not recommended to bind multiple page controls to the same item.
- PageToSource does not update the items with the values from Image controls. Use the HLinkMemo function.
- PageToSource 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.
Updating data in the Table control (or in Looper controls) PageToSource has no effect on the content of a Table control. The actual data transfer from a Table control to its data source (data file or variable) is performed when saving. This saving is performed: - when the input is finished if the option "Save during row exit (Modif.)" is selected ("Details" tab of the Table control description window).
- with the TableSave function.
The same principle applies to the Looper controls bound to a data source.
|
|
|
|