OPEN DIALOG

OPEN DIALOG operand1 [USING] [PARENT] operand2  
  [[GIVING] [DIALOG-ID] operand3]

WITH

operand4

 

M

 

(AD= O )
  A  
nX
PARAMETERS - clause

This document covers the following topics:

For explanations 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

Function

This statement is used to open a dialog dynamically.

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.