ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Web-specific functions / Page functions
  • Retrieving parameters
  • Principle for opening a frameset
  • Operations run when opening the frameset
  • Multilingual sites
  • Pre-launched sessions
  • 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 frameset in the user's browser and closes all the current page and frameset contexts.
If FramesetUse is used in a button code, the frameset will be opened in the target defined for this button ("General" tab of the control description or ChangeTarget).
Example
// Switch the application to English
Nation(nationEnglish)
// Redisplay the FSET_LOGIN frameset with caption in English
FramesetUse(FSET_LOGIN)
Syntax
FramesetUse(<Frameset name> [, <Parameter 1> [... [, <Parameter N>]]])
<Frameset name>: Character string
Name of frameset to display.
If this parameter corresponds to an empty string (""), the frameset name is the one of the frameset to which the current event belongs.
<Parameter 1>: Type of value sent to the page (optional)
Parameters that will be passed to the "Global declarations" event of the frameset to open. These parameters are passed by reference and are considered as global variables to the frameset and to all the pages of the frameset.
<Parameter N>: Type of value sent to the page (optional)
Parameters that will be passed to the "Global declarations" event of the frameset to open. These parameters are passed by reference and are considered as global variables to the frameset and to all the pages of the frameset.
Remarks

Retrieving parameters

To retrieve the parameters, in the "Global declarations" event of the frameset, specify the following line at the beginning of the code:
PROCEDURE <Frameset name>(<Parameter 1> [,...[, <Parameter N>]])

Principle for opening a frameset

FramesetUse does the following:
  • create a frameset context on the server.
  • create a page context on the server for all the frameset pages on the server.
  • return the frameset to the user's browser.

Operations run when opening the frameset

The different operations that can be performed when displaying the frameset are as follows:
  • Running the "Global declarations" and "Initializing" events of the frameset.
  • Opening the frameset pages (run the "Global declarations" and "Initializing" events for each page).
  • WLanguage code after the call to FramesetUse (if used).

Multilingual sites

FramesetUse can be used in multilingual sites. Indeed, this function is used to reopen a frameset while taking into account the language specified by Nation.

Pre-launched sessions

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.

Miscellaneous

  • It is recommended to use FramesetRefresh to redisplay a frameset.
  • To display a frameset without closing the contexts opened on the server, we recommend that you use FramesetDisplay.
  • You should not use WLanguage code after a call to FramesetUse.
Component: wd290page.dll
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help