ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Web-specific functions / Page functions
  • 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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Displays a WEBDEV page in the user's browser and closes all page contexts currently open on the server.
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 in multilingual sites. This function is used to reopen a page while taking into account the language specified by Nation.

Principle for opening a page

<Page>.Use does the following:
  • close all the opened context on the server
  • create a page context on the server
  • returning the page to the browser of web user.
Remark: If <Page>.Use is used in the code of a Button control, the page will be opened in the target defined for this Button control ("General" tab of the control description or ChangeTarget).

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

The following events are run when the page is displayed:
  • 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 after the call to <Page>.Use (if used).
WEBDEV - Server codeWindows

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 redisplay a page, it is recommended to 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.
  • If your project uses pre-launched sessions, this function must not be used in the project initialization event. This function must be used in the "Initializing the project after connection to the site" event.
Component: wd290page.dll
Minimum version required
  • Version 24
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help