PageDisplayDialog (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Web-specific functions / Page functions

Resulting display
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

PageDisplayDialog (Function)

In french: PageAfficheDialogue

Displays a page in modal mode. This function is used to establish a dialog with the user. The page is displayed in the foreground while the opening page is displayed in the background, grayed by the DDW mechanism. For more details, see "Resulting display".

The code of the page is locked until the page is closed by PageCloseDialog. The page can return a value.

Example

// Displays a page allowing the user to exit from the site
IF PageDisplayDialog(PAGE_Exit) = True THEN 
	// Displays an end page
	PageDisplay(PAGE_End)
	// Close the session
	EndProgram()
END

// Displays a page to validate the information entered in the form
PageDisplayDialog(PAGE_Info, EDT_LastName, EDT_FirstName, EDT_Email_Address)

Syntax

<Result> = PageDisplayDialog(<Page> [, <Parameter 1> [... [, <Parameter N>]]])

<Result>: Type corresponding to the retrieved value (optional)

Value retrieved when closing the page to open. This value is returned:
by the Return keyword in the page closing code,
by the PageCloseDialog function,
by the ReturnedValue property used before closing the page,
by the ContextClose function.
<Result> corresponds to False and an error is displayed if the user presses the browser "Back" button.

<Page>: Page name

Name of the page to open. This page must be a non-AWP dynamic page that does not use AJAX code.

<Parameter 1>: Type of value sent to the page (optional)

First parameter that will be passed to the "Global declarations" event of the page to open. This parameter is passed by reference and is considered as a variable global to the page.

<Parameter N>: Type of value sent to the page (optional)

Nth parameter that must be passed to the "Global declarations" event of the page to open. This parameter is passed by reference and is considered as a variable global to the page.

Remarks

Resulting display

The display is as follows: the page displayed by PageDisplayDialog is displayed in the foreground.

Only the border and the content of the page are displayed: This page has no title bar, no taskbar, ... Regardless of its color, the page background is ignored.

The page that used PageDisplayDialog is in the background. This page is grayed by DDW (Dim Disabled Pages). The DDW feature can be configured by PageEnableDDW and PageRateDDW.

Remark: The opened page is not automatically centered: the display mode of the page must be defined in in its characteristics. We advise you to include a large part of the page in a cell with a background color in order to avoid the display effects caused by the DDW feature.

Limitations

The page displayed must be a non-AWP dynamic page.
PageDisplayDialog must be used in a non-AWP dynamic page.
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.

Related Examples:

Training (WEBDEV): WW_Wizard

[ + ] WEBDEV allows you to create your own Web wizards, via the WLanguage PageDisplayDialog function that is used to display a page in a modal way.

This allows you to establish a dialog with the user.
To go from a wizard plane to another one, all you have to do is use the concept of plane found in WEBDEV.

Component: wd300page.dll