
Natural for Windows	Version 8.3.7 for Windows	SEARCH CONTENTS \| PDF BOOKS \| HOME UP PREV NEXT

— Statements —

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:

Function
Syntax Description

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

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

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.

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.

SEARCH CONTENTS | PDF BOOKS | HOME UP PREV NEXT