Version 6.3.8 für Windows
 —  Statements  —

SEND EVENT

SEND EVENT   operand1 TO [DIALOG-ID]

operand2

           
*DIALOG-ID            
 

WITH  

operand3

(AD=

M
O
A

)

 
 
  nX              
  USING [DIALOG] 'dialog-name'  WITH  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: OPEN DIALOG | CLOSE DIALOG | PROCESS GUI

Gehört zur Funktionsgruppe: Ereignisgesteuerte Programmierung


Funktion

Das SEND EVENT-Statement dient dazu, Benutzerereignisse (Events) in einer Natural-Anwendung auszulösen.

Seitenanfang

Syntax-Beschreibung

Operanden-Definitionstabelle:

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

Syntax-Element-Beschreibung:

operand1

operand2

Operanden:

operand1 ist der Name des zu sendenden Ereignisses.

operand2 ist der Bezeichner (Identifier) des Dialoges, der das Benutzerereignis empfängt. operand2 muss mit Format/Länge I4 definiert werden.

operand3
Übergabe von Parametern an den Dialog:

Es ist möglich, Parameter an den Dialog zu übergeben.

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

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

AD=
Definition von Attributen:

Wenn operand3 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. Dies ist die Standardeinstellung.
AD=A Nur Eingabe, siehe Session-Parameter AD=A.
operand3 kann nicht explizit angegeben werden, wenn operand3 eine Konstante ist. AD=O gilt immer für Konstanten.
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.

PARAMETERS-Klausel

PARAMETERS {parameter-name=operand3}  
END-PARAMETERS

Anmerkung:
Sie können Sie PARAMETERS-Klausel nur benutzen, wenn der angegebene Zieldialog (dialog-name) katalogisiert ist.

dialog-name ist der Name des Dialogs, der das Benutzerereignis empfängt.

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.

Seitenanfang

Weitere Informationen und Beispiele

Siehe Event-Driven Programming Techniques im Leitfaden zur Programmierung.

Seitenanfang