FileToPage (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

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 link
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

FileToPage (Function)

In french: FichierVersPage

Not available with this kind of connection

Automatically initializes the controls of a page with:

the values of the associated items in the current record (loaded in memory) of the 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).

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: FileToPage 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 (HRead, HReadSeek, HReadFirst, etc.). Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Example

HReadSeekFirst(CUSTOMER, NAME, "PAUL")
IF HFound() = True THEN FileToPage()

// Read the record and transfer the items to the controls
HReadFirst(CUSTOMER, NAME)
FileToPage()

Syntax

FileToPage([<Page> [, <Source>]])

<Page>: Page name

Name of the page where the controls must be initialized with the values of the current record in the data file. If this parameter is not specified or if it corresponds to an empty string (""), the page to which the current code belongs will be used.
If this parameter is specified, it must correspond to the name of the current page. Otherwise, an error occurs.

<Source>: Optional character string (with quotes)

Name 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 page 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 link

Two types of links can be found between a control and an item:

direct link: In this case, FileToPage 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.

Miscellaneous

Space characters in HFSQL items are kept.
FileToPage assigns the image controls linked to image memo items.
FileToPage does not operate with the views. The items must be assigned one by one to the controls.

Component : wd250page.dll