<Page>.Use (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Parameters passed to the page to open
Multilingual sites
Principle for opening a page
Events and codes run when <Page>.Use is called
Opening a page of an external component
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Page>.Use (Function)

In french: <Page>.Utilise

Displays a WEBDEV page in the browser of the Web user and closes all the current page contexts.

If the <Page>.Use function is used in the code of an Button control, the page will be opened in the destination defined for this Button control ("General" tab of the description of the ChangeTarget field or function).

Versions 15 and later

This function is now available for PHP sites.

New in version 15

This function is now available for PHP sites.

This function is now available for PHP sites.

Versions 24 and later

This function is now available in Ajax mode.

New in version 24

This function is now available in Ajax mode.

Example

// Switch the application to English
Nation(nationEnglish)
// Redisplay the PAGE_Login page with captions in English
PAGE_Login.Use()

Syntax

<Page>.Use([<Parameter 1> [... [, <Parameter N>]]])

<Page>: Page name

Name of the page to display.br>In test mode, specify the full path of the page if the page to open is in a directory other than the project directory

<Parameter 1>: Type of value sent to the page (optional)

Parameter(s) to pass to the opening event of the page to be opened ("Global declarations" event of the page). These parameters are passed by reference and are considered as global variables to the page.

<Parameter N>: Type of value sent to the page (optional)

Parameter(s) to pass to the opening event of the page to be opened ("Global declarations" event of the page). These parameters are passed by reference and are considered as global variables to the page.

Remarks

Parameters passed to the page to open

The parameters are retrieved in the opening event of the page ("Global declarations" event of the page). Simply write the following line at the beginning of the "global declarations" event:

PROCEDURE <Page name> (<Parameter 1> [, ...[, <Parameter N>]]])

Multilingual sites

<Page>.Use can be used for the multilingual sites. Indeed, this function is used to re-open a page while taking into account the language specified by Nation.

Principle for opening a page

The following operations are performed by <Page>.Use:

close all the opened context on the server
create a page context on the server
returning the page to the browser of web user.

Events and codes run when <Page>.Use is called

The different events and codes executed when the page is displayed are as follows:

Page opening code ( "Global declarations" event of the page).
"Initializing" event of the page controls.
Display page in the browser.
Javascript code associated with the page and the controls.
WLanguage code following the call to <Page>.Use (if it exists).

Opening a page of an external component

To open a page of an external component, use the name of the page of the external component (the component being included in the project). For example:

ComponentPage.Use()

If a conflict occurs with a project element, the name of the element must be prefixed by the name of the external component. For example:

MyComponent.Page.Use()

To use the name of the page in a variable, the name of the external component must be specified. For example:

sPage is string = "MyComponent.MyPage"

sPage.Use()

Miscellaneous

To re-display a page, we recommend that you use <Page>.Refresh.
To display a page without closing the contexts opened on the server, we recommend that you use <Page>.Display.
You should not use WLanguage code after a call to <Page>.Use.
Versions 20 and later
If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site".
New in version 20
If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site".
If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site".

Component: wd260page.dll