ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Web-specific functions / Page functions
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 Popup control in a page with a DDW effect (Dim Disabled Windows). This function is used to easily simulate a dialog box in browser code, by using a Popup control of the page.
Remark: To display a Popup control, PopupDisplay can be used:
  • in the code of a Button control with the option "Run browser click code only". In this case, only the browser code of the Button control will be executed.
  • in a Button control with the option "Run server and browser codes" (that sends values to the server). AJAX must be enabled in the code of this Button control. In this case, the browser code and server codes of the control will be executed.
Example
PopupDisplay(POPUP_Question, popupCenter)
Syntax

Displaying a Popup control at a specific position Hide the details

PopupDisplay(<Popup> [, <Display options> [, <X> [, <Y>]]])
<Popup>: Control name
Name of the Popup control to be displayed.
<Display options>: Optional Integer constant
Popup control display options corresponding to one of the following constants:
popupBottomCenterThe Popup control is centered at the bottom of the visible part of the current page.
popupBottomLeftThe Popup control is at the bottom left of the visible part of the current page.
popupBottomRightThe Popup control is at the bottom right of the visible part of the current page.
popupCenter
(Default value)
The Popup control is centered in the visible part of the current page.
popupCenterLeftThe Popup control is centered to the left of the visible part of the current page.
popupCenterRightThe Popup control is centered to the right of the visible part of the current page.
popupDiscardableThe Popup control can be discarded: the popup can be closed by pressing ESC or by clicking outside the popup.
This constant can be combined with one of the other constants to position the Popup control.
popupFixedThe Popup control is pinned at the specified position: the position of the Popup control will not change if the page is scrolled or if the browser size is modified.
This constant can be combined with another position constant of the Popup control (excluding popupPositionXY and popupMouseXY).
popupMouseXYThe Popup control will be opened at the position of the mouse. This constant can only be used in a browser event (of a control or page). This constant cannot be used:
  • in browser procedures.
  • in the events directly or indirectly called from a browser procedure (via ExecuteProcess for example).
  • in the browser code of a Button or Link control.
WEBDEV - Server codePHP This constant is not available.
popupPositionXYThe Popup control will be opened at the specified X and Y positions.
popupTopCenterThe Popup control is centered at the top of the visible part of the current page.
popupTopLeftThe Popup control is at the top left of the visible part of the current page.
popupTopRightThe Popup control is at the top right of the visible part of the current page.
<X>: Optional integer
If the constant popupPositionXY is used, indicates the X position of the Popup control (in relation to the upper-left corner of the page). This parameter is expressed in pixels.
<Y>: Optional integer
If the constant popupPositionXY is used, indicates the Y position of the Popup control (in relation to the upper-left corner of the page). This parameter is expressed in pixels.
WEBDEV - Browser code

Displaying a Popup control relatively to a control Hide the details

PopupDisplay(<Popup> , <Base control> [, <Display options> [, <X> [, <Y>]]])
<Popup>: Control name
Name of the Popup control to be displayed.
<Base control>: Control name
Name of the control that serves as a reference to display the Popup control.
<Display options>: Optional Integer constant
Popup control display options corresponding to one of the following constants:
popupBottomCenterThe Popup control is centered at the bottom of the control.
popupBottomLeft
(Default value)
The Popup control is at the bottom left of the control.
popupBottomRightThe Popup control is at the bottom right of the control.
popupCenterThe Popup control is centered relative to the base control.
popupCenterLeftThe Popup control is centered to the left relative to the base control.
popupCenterRightThe Popup control is centered to the right relative to the base control.
popupDiscardableThe Popup control can be discarded: the popup can be closed by pressing ESC or by clicking outside the popup.
This constant can be combined with one of the other constants to position the Popup control.
popupPositionXYThe Popup control will be displayed at the specified X and Y positions.
popupTopCenterThe Popup control is centered at the top, relative to the base control.
popupTopLeftThe Popup control is at the top left relative to the base control.
popupTopRightThe Popup control is at the top right relative to the base control.
<X>: Optional integer
If the popupPositionXY constant is used, indicates the display X position of the popup (in relation to the upper-left corner of the control). This parameter is expressed in pixels.
<Y>: Optional integer
If the popupPositionXY constant is used, indicates the display Y position of the popup (in relation to the upper-left corner of the control). This parameter is expressed in pixels.
Remarks
  • The Popup control displayed can be hidden with PopupClose.
  • The browsers do not refresh the display in the middle of a JavaScript code: PopupDisplay and PopupClose must be used in different events/processes. If these functions are used in the same event/process, the Popup control is not displayed.
  • Two different Popup or Cell controls cannot be displayed at the same time by PopupDisplay or CellDisplayDialog.
  • The DDW (Dim Disabled Windows) can be disabled and customized:
  • WEBDEV - Server code This function cannot be used in the scheduled tasks and in the delayed tasks. For more details, see Scheduled and delayed tasks.
Business / UI classification: UI Code
Component: wd290page.dll
Minimum version required
  • Version 17
Comments
Click [Add] to post a comment

Last update: 03/23/2023

Send a report | Local help