ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Web-specific functions / Page functions
  • Resulting display
  • Limitations
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 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:
<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 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.
  • <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 "Initialization in pre-launched session mode" event.
Related Examples:
WW_Wizard 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
Minimum version required
  • Version 24
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help