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.

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.

This control is intended to be used in the page that opens the pop-up dialog. An example for the usage of the control is provided in the Natural for Ajax demos as program CTRPOP-P.

The following topics are covered below:

Example
Adapter Interface

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") or as a page pop-up (value "PAGEPOPUP").
`TITLE`	The title to be displayed in the caption of the pop-up dialog.
`TOP/TOPPOS`	The top 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`.
`WIDTH`	The width of the pop-up dialog. 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.