OPEN DIALOG

#### Search Results

Search

# OPEN DIALOG

`OPEN DIALOG` operand1 [`USING`] [`PARENT`] operand2
[[`GIVING`] [`DIALOG-ID`] operand3]
| `WITH` |  |  | operand4 |  |  |  | `M` |  |  |  |  |  |
(`AD=` | `O` | )
| `A` |
n `X`
PARAMETERS - clause

This document covers the following topics:

- OPEN DIALOG Usage

- OPEN DIALOG Syntax Description

- Further Information and OPEN DIALOG Examples

For an explanation of the symbols used in the syntax diagram, see Syntax Symbols.

Related Statement: `CLOSE DIALOG` | `PROCESS GUI` | `SEND EVENT`

Belongs to Function Group: Event-Driven Programming

## OPEN DIALOG Usage

This statement is used to open a dialog dynamically.

## OPEN DIALOG Syntax Description

Operand Definition Table:

Operand | Possible Structure | Possible Formats | Referencing Permitted | Dynamic Definition
--- | --- | --- | --- | ---
`operand1` | C | S |  |  |  | A |  |  |  |  |  |  |  |  |  |  |  |  | yes | no
`operand2` | C | S |  |  |  |  |  |  |  |  |  |  |  |  |  |  | G |  | no | no
`operand3` |  | S |  |  |  |  |  |  |  | I |  |  |  |  |  |  |  |  | yes | no
`operand4` | C | S | A |  |  | A | U | N | P | I | F | B | D | T | L | C | G | O | yes | no

Syntax Element Description:

Syntax Element | Description
--- | ---
`operand1` | Dialog Name: `operand1` is the name of the dialog to be opened. `operand1` must be a constant if the `PARAMETERS-clause` is used.
`operand2` | Handle Name: `operand2` is the handle name of the parent.
`operand3` | Dialog ID: `operand3` is a unique identifier returned from the creation of the dialog. It must be defined with format/length I4.
`operand4` | Passing Parameters to the Dialog: When a dialog is opened, parameters may be passed to this dialog. As `operand4` you specify the parameters which are passed to the dialog.
`PARAMETERS-clause` | Passing Parameters Selectively: With the `PARAMETERS-clause`, parameters may be passed selectively. For full details, see PARAMETERS Clause below. Note: You can only use the PARAMETERS-clause if operand1 is a constant and the dialog is cataloged.
`nX` | Specifying Parameters to be Skipped: With the notation `nX` you can specify that the next `n` parameters are to be skipped (for example, `1X` to skip the next parameter, or `3X` to skip the next three parameters); this means that for the next `n` parameters no values are passed to the dialog. A parameter that is to be skipped must be defined with the keyword `OPTIONAL` in the dialog's `DEFINE DATA PARAMETER` statement. `OPTIONAL` means that a value can - but need not - be passed from the invoking object to such a parameter.
`AD=` |
Attribute Assignment: If `operand4` is a variable, you can mark it in one of the following ways:
`AD=O` | Non-modifiable, see session parameter `AD=O`.
`AD=M` | Modifiable, see session parameter `AD=M`.
`AD=A` | Input only, see session parameter `AD=A`.
`operand4` cannot be explicitly specified if `operand4` is a constant. `AD=O` always applies to constants.

### PARAMETERS Clause

`PARAMETERS` {parameter-name `=` operand4}
`END-PARAMETERS`

Syntax Element Description:

Syntax Element | Description
--- | ---
`parameter-name` | Parameter Name: The name of the parameter as defined in the parameter data area section of the dialog. Note If the value of a parameter marked with `AD=O` and passed "by reference" is changed in a dialog, this will lead to a runtime error.
`operand4` | Parameters to be Passed: As `operand4` you specify the parameters which are passed to the dialog.
`END-PARAMETERS` | End of PARAMETERS Clause: The Natural reserved word `END-PARAMETERS` must be used to end the PARAMETERS clause.

## Further Information and OPEN DIALOG Examples

See the section Event-Driven Programming Techniques in the Programming Guide.

### On this page

- OPEN DIALOG Usage
- OPEN DIALOG Syntax Description
- Further Information and OPEN DIALOG Examples