<Page>.DisplayDialog (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Web-specific functions

Page management functions

Prefix syntax

DisplayDialog

Presentation

Example

Resulting display

Limitations

Related examples

See also

<Page>.DisplayDialog (Function)

In french: <Page>.AfficheDialogue

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 PAGE_Exit.DisplayDialog() = True THEN
// Displays an end page
PAGE_End.Display()
// Close the session
EndProgram()
END

// Displays a page to validate the information entered in the form
PAGE_Info.DisplayDialog(EDT_LastName, EDT_FirstName, EDT_Email_address)

Syntax

<Result> = <Page>.DisplayDialog([<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.

<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 <Page>.DisplayDialog 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 <Page>.DisplayDialog is in the background. This page is grayed by DDW (Dim Disabled Pages). The DDW feature can be configured by PageActivateDDW 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.
<Page>.DisplayDialog 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 "Initializing the project after connection to the site" 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: wd280page.dll