PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Parameters passed to the page to open
  • Multilingual sites
  • Principle for opening a page
  • Process run during the call to PageUse
  • Opening a page of an external component
  • Various
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
PageUse (Function)
In French: PageUtilise
AjaxNot available
Displays a WEBDEV page in the browser of the Web user and closes all the current page contexts.
If PageUse is used in a button code, the page will be opened in the target defined for this button ("General" tab of control description or ChangeTarget).
Versions 15 and later
PHP This function is now available for the PHP sites.
New in version 15
PHP This function is now available for the PHP sites.
PHP This function is now available for the PHP sites.
Example
// Switch the application to English
Nation(nationEnglish)
// Redisplay the PAGE_Login page with captions in English
PageUse(PAGE_Login)
Syntax
PageUse(<Page> [, <Parameter 1> [... [, <Parameter N>]]])
<Page>: Character string (with or without quotes)
Name of page to display.
If this parameter is equal to an empty string (""), the page name is the name of the page to which the current process belongs.
In test mode, specify the full path of the page if the page to open is located in a directory other than the project directory.
<Parameter 1>: Type of value sent to the page (optional)
Parameters that will be passed to the opening process of the page to display. These parameters are passed by address and they are considered as being variables global to the page.
<Parameter N>: Type of value sent to the page (optional)
Parameters that will be passed to the opening process of the page to display. These parameters are passed by address and they are considered as being variables global to the page.
Remarks

Parameters passed to the page to open

The parameters are retrieved in the opening process of the page. To do so, specify the following line at the beginning of process:
PROCEDURE <Page Name> (<Parameter 1> [, ...[, <Parameter N>]]])

Multilingual sites

PageUse 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 PageUse:
  • close all the opened context on the server
  • create a page context on the server
  • returning the page to the browser of web user.

Process run during the call to PageUse

The following processes are run when the page is displayed:
  • Opening code of page
  • Initialization code of controls
  • Display the page in the browser
  • Javascript code associated with the page and the controls
  • WLanguage code following the call to PageUse (if it exists)
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:
PageUse(ComponentPage)
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:
PageUse(MyComponent.Page)
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"

PageUse(sPage)

Various

  • To re-display a page, we recommend that you use PageRefresh.
  • To display a page without closing the contexts opened on the server, we recommend that you use PageDisplay.
  • You should not use WLanguage code after a call to PageUse.
  • Versions 20 and later
    If your project is using cached sessions, this function must not be used in the "Initializing the project" process. This function must be used in the "Initializing the project after connection to the site" process.
    New in version 20
    If your project is using cached sessions, this function must not be used in the "Initializing the project" process. This function must be used in the "Initializing the project after connection to the site" process.
    If your project is using cached sessions, this function must not be used in the "Initializing the project" process. This function must be used in the "Initializing the project after connection to the site" process.
Components
WEBDEV - Server code wd230page.dll
Linux wd230page.so
Minimum required version
  • Version 9
Comments
Click [Add] to post a comment