PopupDisplay (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Functions specific to WEB

Page management functions

See also

PopupDisplay (Function)

In french: PopupAffiche

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.

Versions 18 and later

This function is now available for WEBDEV sites in Windows.

This function is now available for PHP sites.

New in version 18

This function is now available for WEBDEV sites in Windows.

This function is now available for PHP sites.

This function is now available for WEBDEV sites in Windows.

This function is now available for PHP sites.

Example

PopupDisplay(POPUP_Question, popupCenter)

Syntax

Displaying a Popup control at a specific position Hide the details

PopupDisplay(<Popup> [, <Display position> [, <X> [, <Y>]]])

<Popup>: Control name

Name of the Popup control to display.

<Display position>: Optional Integer constant

Position to display the Popup control corresponding to one of the following constants:
Versions 26 and later
popupDiscardable
New in version 26
popupDiscardable
popupDiscardable The 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.
Versions 18 and later
popupBottomCenter
New in version 18
popupBottomCenter
popupBottomCenter The Popup control is centered at the bottom of the visible part of the current page.
popupBottomRight The Popup control is at the bottom right of the visible part of the current page.
popupBottomLeft The Popup control is at the bottom left of the visible part of the current page.
popupCenter
(Default value) The Popup control is centered in the visible part of the current page.
Versions 18 and later
popupCenterRight
New in version 18
popupCenterRight
popupCenterRight The Popup control is centered to the right of the visible part of the current page.
Versions 18 and later
popupCenterLeft
New in version 18
popupCenterLeft
popupCenterLeft The Popup control is centered to the left of the visible part of the current page.
Versions 18 and later
popupFixed
New in version 18
popupFixed
popupFixed The 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).
Versions 18 and later
popupTopCenter
New in version 18
popupTopCenter
popupTopCenter The Popup control is centered at the top of the visible part of the current page.
popupTopRight The Popup control is at the top right of the visible part of the current page.
popupTopLeft The Popup control is at the top left of the visible part of the current page.
popupPositionXY The Popup control will be opened at the specified X and Y positions.
popupMouseXY The 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.
This constant is not available.

<X>: Optional integer

If the constant popupPositionXY is used, indicates the X position of the Popup control (in relation to the top 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 top left corner of the page). This parameter is expressed in pixels.

Displaying a Popup control relatively to a control Hide the details

PopupDisplay(<Popup> , <Base control> [, <Display position> [, <X> [, <Y>]]])

<Popup>: Control name

Name of the Popup control to display.

<Base control>: Control name

Name of the control that serves as a reference to display the Popup control.

<Display position>: Optional Integer constant

Position to display the Popup control corresponding to one of the following constants:
Versions 26 and later
popupDiscardable
New in version 26
popupDiscardable
popupDiscardable The 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.
Versions 18 and later
popupBottomCenter
New in version 18
popupBottomCenter
popupBottomCenter The Popup control is centered at the bottom of the control.
popupBottomRight The Popup control is at the bottom right of the control.
popupBottomLeft
(Default value) The Popup control is at the bottom left of the control.
popupCenter The Popup control is centered relative to the base control.
Versions 18 and later
popupCenterRight
New in version 18
popupCenterRight
popupCenterRight The Popup control is centered to the right relative to the base control.
Versions 18 and later
popupCenterLeft
New in version 18
popupCenterLeft
popupCenterLeft The Popup control is centered to the left relative to the base control.
Versions 18 and later
popupTopCenter
New in version 18
popupTopCenter
popupTopCenter The Popup control is centered at the top, relative to the base control.
popupTopRight The Popup control is at the top right relative to the base control.
popupTopLeft The Popup control is at the top left relative to the base control.
popupPositionXY The Popup control will be displayed at the specified X and Y positions.

<X>: Optional integer

If the popupPositionXY constant is used, indicates the display X position of the popup (in relation to the top 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 top 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:
- from the description window of a page.
- by programming with PageActivateDDW and PageRateDDW.
This function cannot be used in the scheduled tasks and in the delayed tasks. See Scheduled and delayed tasks for more details.

Business / UI classification: UI Code

Component: wd260wl2js.dll