SHOWPOPUP
Syntax
Command
Mandatory parameter Optional parameter Mandatory keyword Optional keyword |
SHOWPOPUP (<Popup form>)
Description
Opens the specified popup form.
Diagram
Returned value type
None
Parameters
| Parameter | Description |
| <Popup Form> | Expression giving the name of the popup form that must be displayed. |
Remarks
A SHOWPOPUP is implicitly being followed by a REFRESH. This means that the DISPLAY_MAIN will not be executed.
In addition a SHOWPOPUP command also sets the ERROR system item to true.
When a popup screen is called, it will be regarded as a new subsession. At the time that this subsession (popup screen) is presented, the other AMT Screens functionality will be disabled. Both the calling form and the popup form will always use the same shared session data.
| Popup subsessions do not count towards the maximum allowed number of subsessions. |
Per form, there can be opened only one single popup form, which will always be shown in the center on top of the calling screen. The size of the popup window and the abilities for the end user to change this, depend on the properties that are set at design time.
A popup form can be closed dynamically with a CLOSEFORM instruction. It is also closed when the end user clicks the cross mark (X) in the popup window header. After the popup screen is closed, the calling screen will become active again. The PROCESS MAIN of the calling screen will then also be executed again.
It is possible, to specify another SHOWPOPUP instruction inside a popup form, it is not possible to use a GOTOFORM instruction inside a popup form except when using the BYE option.
A SHOWPOPUP cannot be executed in combination with another SHOWPOPUP, a GOTOFORM (except when using the NEW option), REFRESH or CLOSEFORM. If any combination of the mentioned commands is encountered within a single transaction, then only the last of these commands is executed. This means in practice that if the code of a single form contains the successive commands GOTOFORM (‘Form_Y’, ‘HELP10’, NEW) and GOTOFORM (‘Form_Z’, ‘HELP20’, NEW), then "Form_Z" will not be launched in case the form "Form_Y" contains a SHOWPOPUP in its DISPLAY_MAIN.
| When a Form is COM and or Webservice enabled popup forms will NOT show when the Form is accessed through the COM module or accessed as a Webservice. |
Form calling priority
The commands ‘gotoform’, ‘refresh’, ‘closeform’ and ‘showpopup’, all execute the remaining display/process main logic, so it is possible that multiple instances of these commands are encountered before the transaction has ended.
The table below explains which command takes priority and is ultimately executed.
1 Indicates that this command overrules the previously encountered command, which is now not executed.
2 Indicates that the previous command takes precedence over this command, so it is the previous command only that is executed.
3 Indicates that both commands will be executed.
| This command | Previous command | |||||
| gotoform (form) | gotoform (BYE) | refresh () | closeform () | showpopup (popup form) | gotoform ( form, , NEW) | |
| gotoform (form) | 1 | 1 | 1 | 1 | 1 | 3 |
| gotoform (BYE) | 1 | - | 1 | 1 | 1 | 1 |
| refresh () | 1 | 1 | - | 1 | 1 | 3 |
| closeform () | 1 | 1 | 1 | - | 1 | 3 |
| showpopup (popup form) | 1 | 1 | 1 | 1 | 1 | 1 |
| gotoform ( form, , NEW) | 3 | 2 | 3 | 3 | 1 | 3 |
Example