Version 6.3.8 für Windows
 —  Statements  —

OPEN DIALOG

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

WITH

operand4

 

M

 

(AD= O )
  A  
nX
PARAMETERS - clause

Dieses Dokument behandelt folgende Themen:

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.

Verwandte Statements: CLOSE DIALOG | PROCESS GUI | SEND EVENT

Gehört zur Funktionsgruppe: Ereignisgesteuerte Programmierung


Funktion

Dieses Statement dient dazu, einen Dialog dynamisch zu öffnen.

Seitenanfang

Syntax-Beschreibung

Operanden-Definitionstabelle:

Operand Mögliche Struktur Mögliche Formate Referenzierung erlaubt Dynam. Definition
operand1 C S       A                         ja nein
operand2 C S                             G   nein nein
operand3   S               I                 ja nein
operand4 C S A     A U N P I F B D T L C G O ja nein

Syntax-Element-Beschreibung:

operand1
Dialogname:

operand1 ist der Name des zu öffnenden Dialogs. Wenn die PARAMETERS-Klausel benutzt wird, muss operand1 eine Konstante sein.

operand2
Handle-Name:

operand2 ist der Handle-Name des Parent.

operand3
Dialog-ID:

operand3 ist ein eindeutiger Bezeichner, der nach der Dialogerstellung zurückgegeben wird. Er muss mit Format/Länge I4 definiert werden.

 
Übergabe von Parametern an den Dialog:

Wenn ein Dialog geöffnet wird, können Parameter an diesen Dialog übergeben werden.

operand4

Als operand4 geben Sie die Parameter an, die an den Dialog übergeben werden.

PARAMETERS-clause
Selektive Übergabe von Parametern:

Mit der PARAMETERS-Klausel können Parameter selektiv übergeben werden. Siehe PARAMETERS-Klausel unten.

Anmerkung:
Sie können die PARAMETERS-Klausel nur benutzen, wenn operand1 eine Konstante ist und der Dialog katalogisiert ist.

nX
Angabe zu überspringender Parameter:

Mit der Notation nX können Sie angeben, dass die nächsten n Parameter übersprungen werden (zum Beispiel 1X, um den nächsten Parameter zu überspringen, oder 3X, um die nächsten drei Parameter zu überspringen); dies bedeutet, dass für die nächsten n Parameter keine Werte an den Dialog übergeben werden. Ein zu überspringender Parameter muss im DEFINE DATA PARAMETER-Statement des Dialogs mit dem Schlüsselwort OPTIONAL definiert werden. OPTIONAL bedeutet, dass ein Wert von dem aufrufenden Objekt an einen solchen Parameter übergeben werden kann - aber nicht muss.

AD=
Definition von Attributen:

Wenn operand4 eine Variable ist, können Sie sie folgendermaßen kennzeichnen:

AD=O Nicht änderbar, siehe Session-Parameter AD=O.
AD=M Änderbar, siehe Session-Parameter AD=M.
AD=A Nur Eingabe, siehe Session-Parameter AD=A.
operand4 kann nicht explizit angegeben werden, wenn operand4 eine Konstante ist. AD=O gilt immer für Konstanten.

PARAMETERS-Klausel

PARAMETERS {parameter-name = operand4}
END-PARAMETERS

Syntax-Element-Beschreibung:

parameter-name Der Name des Parameters wie er in der Parameter Data Area des Dialogs definiert ist.

Anmerkung:
Es führt zu einem Laufzeitfehler, wenn der Wert eines Parameters, der mit AD=O markiert und "By Reference" übergeben wird, im Dialog geändert wird.

operand4 Als operand4 geben Sie die Parameter an, die an den Dialog übergeben werden.
END-PARAMETERS Das für Natural reservierte Schlüsselwort END-PARAMETERS muss zum Beenden der PARAMETERS-Klausel verwendet werden.

Seitenanfang

Weitere Informationen und Beispiele

Siehe Event-Driven Programming Techniques im Leitfaden zur Programmierung.

Seitenanfang