NJX:XCIOPENPOPUP

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:

Example
Adapter Interface
Non-responsive pages
Responsive pages

Example

The XML code for the example looks as follows:

<natpage xmlns:njx="http://www.softwareag.com/njx/njxMapConverter">
    <njx:xciopenpopup>
    </njx:xciopenpopup >
</natpage>

Adapter Interface

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)

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"), as a responsive pop-up in a responsive page (value "BMPOPUP"), or as a responsive sliding panel in a responsive page (value "BMPANEL").
`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.

Non-responsive pages