ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Web-specific functions / Page functions
  • Retrieving parameters
  • Principle for opening a frameset
  • Operations run when opening the frameset
  • Multilingual websites
  • Pre-launched sessions
  • Miscellaneous
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
FramesetUse (Function)
In french: FramesetUtilise
Displays a WEBDEV frameset in the user's browser and closes all the current page and frameset contexts.
If the function FramesetUse is used in the code of a button, the frameset will be opened in the destination defined for this button ("General" tab of the field description or function ChangeTarget).
Example
// Passage de l'application en anglais
Nation(nationEnglish)
// Réaffichage du frameset FSET_LOGIN avec libellé en anglais
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 <Nom du frameset>(<Paramètre 1> [,...[, <Paramètre 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 "Initialization" events of the frameset.
  • Opening the frameset pages (run the "Global declarations" and "Initialization" events for each page).
  • WLanguage code after the call to FramesetUse (if used).

Multilingual websites

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 "Initialization in pre-launched session mode" 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: wd300page.dll
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment

Last update: 09/21/2024

Send a report | Local help