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

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)

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.

Non-responsive pages

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.

Responsive pages

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.