PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
New WEBDEV 26 feature!
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Displays a WEBDEV page as a popup in the current page with a DDW (Dim Disabled Windows) effect. This function is used to easily simulate a dialog box in browser code.
Remark: To display a Popup page, <Page>.DisplayPopup 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
// Displays PAGE_ProductDetails as popup
PAGE_ProductDetails.DisplayPopup(nProductID), popupCenter)
Syntax

Opening a Popup page at a specific position Hide the details

<Page>.DisplayPopup([<Parameters> [, <Display position> [, <X> [, <Y>]]]])
<Page>: Page name
Name of page to display.
<Parameters>: List of values enclosed in brackets and separated by commas
Parameters of the page to be displayed. This list of parameters has the following format:
(<Parameter 1>, ..., <Parameter N>)
where:
  • <Parameter 1>: First parameter of the page.
  • ...
  • <Parameter N>: Nth parameter of the page.
Caution:
  • Parameters are passed by value.
  • In a browser code call, values are converted to strings when data is sent to the server. It is recommended to use only simple parameters (boolean, string, integer, etc.)..
<Display position>: Optional Integer constant
Popup display position:
Versions 26 and later
popupDiscardable
New in version 26
popupDiscardable
popupDiscardable
The Popup page can be discarded: the popup can be closed by pressing ESC or by clicking outside the popup.
This constant can be combined with another popup position constant.
popupBottomCenterThe Popup page appears at the bottom center of the visible part of the current page.
popupBottomRightThe Popup page appears at the bottom right of the visible part of the current page.
popupBottomLeftThe Popup page appears at the bottom left of the visible part of the current page.
popupCenter
(Default value)
The Popup page is centered in the visible part of the current page.
popupCenterRightThe Popup page appears in the center and to the right of the visible part of the current page.
popupCenterLeftThe Popup page appears in the center and to the left of the visible part of the current page.
popupFixedThe Popup page is fixed at the specified position: the position of the Popup will not change if the page is scrolled or if the browser is resized.
This constant can be combined with another Popup position constant (excluding popupPositionXY and popupMouseXY).
popupTopCenterThe Popup page appears at the top center of the visible part of the current page.
popupTopRightThe Popup page appears at the top right of the visible part of the current page.
popupTopLeftThe Popup page appears at the top left of the visible part of the current page.
popupPositionXYThe Popup page will be opened at the specified X and Y positions.
popupMouseXYThe Popup page will be opened at the mouse position. 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 code 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 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.
WEBDEV - Browser code

Positioning a Popup page relative to a control Hide the details

<Page>.DisplayPopup(<Parameters> , <Base control> [, <Display position> [, <X> [, <Y>]]])
<Page>: Page name
Name of page to display.
<Parameters>: List of values enclosed in brackets and separated by commas
Parameters of the page to be displayed. This list of parameters has the following format:
(<Parameter 1>, ..., <Parameter N>)
where:
  • <Parameter 1>: First parameter of the page.
  • ...
  • <Parameter N>: Nth parameter of the page.
Caution:
  • Parameters are passed by value.
  • In a browser code call, values are converted to strings when data is sent to the server. It is recommended to use only simple parameters (boolean, string, integer, etc.)..
<Base control>: Control name
Name of the control relative to which the Popup page will be positioned.
<Display position>: Optional integer
Popup display position.
Versions 26 and later
popupDiscardable
New in version 26
popupDiscardable
popupDiscardable
The Popup page can be discarded: the popup can be closed by pressing ESC or by clicking outside the popup.
This constant can be combined with another popup position constant.
popupBottomCenterThe Popup page appears at the bottom center of the control.
popupBottomRightThe Popup page appears at the bottom right of the control.
popupBottomLeft
(Default value)
The Popup page appears at the bottom left of the control.
popupCenterThe Popup page is centered, relative to the base control.
popupCenterRightThe Popup page is centered to the right, relative to the base control.
popupCenterLeftThe Popup page is centered to the left, relative to the base control.
popupTopCenterThe Popup page is centered at the top, relative to the base control.
popupTopRightThe Popup page appears at the top right, relative to the base control.
popupTopLeftThe Popup page appears at the top left, relative to the base control.
popupPositionXYThe Popup page will be opened 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 displayed page is opened on the server.
  • The displayed page can be hidden using <Page>.ClosePopup.
  • The browsers do not refresh the display in the middle of a JavaScript code: <Page>.DisplayPopup and <Page>.ClosePopup must be used in different events/processes. If these functions are used in the same event/process, the page is not displayed.
  • It is not possible to open two popup pages at the same time using <Page>.DisplayPopup.
  • The DDW feature can be disabled and customized in the code, using PageActivateDDW and PageRateDDW.
  • 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.
Component: wd260page.dll
Minimum version required
  • Version 26
Comments
Click [Add] to post a comment