NJX:XCIOPENPOPUP

#### Search Results

Search

# 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)

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.

### On this page

- Example
- Adapter Interface
- Non-responsive pages
- Responsive pages