FramesetDisplay (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Functions specific to WEB

Functions for page management

Retrieving parameters

Principle for opening a frameset

Operations run when opening the frameset

Pre-launched sessions

See also

FramesetDisplay (Function)

In french: FramesetAffiche

Displays a WEBDEV frameset in the browser of Web user.

If FramesetDisplay is used in a button code, the frameset will be opened in the target defined for this button ("General" tab of control description or ChangeTarget).

Versions 16 and later

This function is now available for PHP sites.

New in version 16

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

// Redisplay the FSET_LOGIN frameset
FramesetDisplay(FSET_LOGIN)

Syntax

FramesetDisplay(<Frameset name> [, <Parameter 1> [... [, <Parameter N>]]])

<Frameset name>: Character string (with or without quotes)

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

The following operations are performed by FramesetDisplay:

creating a frameset context on the server
creating a page context on the server for all the frameset pages on the server
send the frameset back to the browser of Web user.

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 following the call to FramesetDisplay (if it exists).

Versions 20 and later

Pre-launched sessions

If your project uses pre-launched sessions, this function must not be used in the event "Initializing" of the project. This function must be used in the event "Initializing the project after connection to the site".

New in version 20

Pre-launched sessions

Component : wd240page.dll