The NJX:XCIOPENPOPUP control is used to configure certain parameters of
a pop-up dialog before it is opened with a PROCESS PAGE MODAL
statement. The control does not have design-time properties, nor does it raise
events.
For non-responsive pages, two types of pop-up dialogs are supported: browser pop-ups and page pop-ups. Browser pop-ups are controlled by the web browser. To use them, pop-ups must be enabled in the browser settings. Page pop-ups are rendered by Natural for Ajax. To use them, pop-ups need not be enabled in the browser settings.
For responsive pages, dynamic modals ( BMOBILE:DYNMODAL) are supported. They are rendered as pure html therefore Browser pop-ups don’t need to be enabled.
This control is intended to be used in the page that opens the pop-up dialog. Examples for the usage of this control are provided in the Natural for Ajax demos.
The following topics are covered below:
The XML code for the example looks as follows:
<natpage xmlns:njx="http://www.softwareag.com/njx/njxMapConverter">
<njx:xciopenpopup>
</njx:xciopenpopup >
</natpage>
1 XCIOPENPOPUP 2 FEATURES (A) DYNAMIC 2 HEIGHT (I4) 2 LEFT (I4) 2 POPUPTYPE (A) DYNAMIC 2 TITLE (A) DYNAMIC 2 TOP (I4) 2 WIDTH (I4)
or
1 XCIOPENPOPUP 2 FEATURES (A) DYNAMIC 2 HEIGHT (I4) 2 LEFT (I4) 2 POPUPTYPE (A) DYNAMIC 2 TITLE (A) DYNAMIC 2 TOPPOS (I4) 2 WIDTH (I4)
TOPPOS is generated in the adapter interface when the
property natkcheck in the
NATPAGE control is set to
"true", otherwise TOP is generated.
Each element of the structure controls a parameter of the next pop-up dialog to be opened.
| Element | Meaning |
|---|---|
FEATURES |
Allows defining specific features of the pop-up dialog.
See the property popupfeatures of the
NATPAGE control.
|
HEIGHT |
The height of the pop-up dialog. If you specify a value
greater than 0, you also need to specify a value greater than 0 for
WIDTH.
|
LEFT |
The left position of the pop-up dialog. If you specify a
value greater than 0, you also need to specify values greater than 0 for
HEIGHT and WIDTH.
|
POPUPTYPE |
Specifies whether the pop-up dialog is to be opened as a browser pop-up (value "POPUP"), as a page pop-up (value "PAGEPOPUP"), or as a responsive pop-up in a responsive page (value "BMPOPUP"). |
TITLE |
The title to be displayed in the caption of the pop-up dialog. |
TOP/TOPPOS |
The top position of the pop-up dialog. For non-responsive
pages: if you specify a value greater than 0, you also need to specify values
greater than 0 for HEIGHT and WIDTH.
|
WIDTH |
The width of the pop-up dialog. For non-responsive pages:
if you specify a value greater than 0, you also need to specify a value greater
than 0 for HEIGHT.
|
Valid values for HEIGHT, WIDTH,
LEFT and TOP/TOPPOS are -1, 0 or a value greater than
0. The value -150, for example, is not a valid value.
Special settings:
To open a centered pop-up, set LEFT and
TOP/TOPPOS to -1.
To open a pop-up in the upper left corner of the browser output
area, set LEFT and TOP/TOPPOS to 0.
To open a pop-up with the default settings, set
HEIGHT, WIDTH, LEFT and
TOP/TOPPOS to -1.
Valid values for HEIGHT, WIDTH,
LEFT and TOP/TOPPOS are -1, 0 or a value greater than
0. The value -150, for example, is not a valid value.
Special settings:
To open a centered pop-up, set LEFT and
TOP/TOPPOS to -1.
To open a pop-up in the upper left corner of the browser output
area, set LEFT and TOP/TOPPOS to 0.
To open a pop-up with the default settings, set
HEIGHT, WIDTH, LEFT and
TOP/TOPPOS to -1.
HEIGHT, WIDTH, LEFT, TOP/TOPPOS values must be greater than 0. If the pop-up is bigger than the containing window, the values are automatically adapted so that the pop-up fits into the parent window. For supported features, see also the chapter “Dynamic Pop-Ups” in the Responsive Controls chapter.