SEND EVENT
|
operand1
TO [DIALOG-ID ]
|
operand2 | ||||||||||||||
*DIALOG-ID
|
||||||||||||||||
WITH
|
operand3 | (AD=
|
) | |||||||||||||
nX |
||||||||||||||||
USING
[DIALOG ]
'dialog-name'
WITH
PARAMETERS-clause |
This document covers the following topics:
For an explanation of the symbols used in the syntax diagram, see Syntax Symbols.
Related Statement: OPEN
DIALOG
| CLOSE
DIALOG
| PROCESS
GUI
Belongs to Function Group: Event-Driven Programming
The SEND EVENT
statement is used to trigger a
user-defined event within a Natural application.
Operand Definition Table:
Operand | Possible Structure | Possible Formats | Referencing Permitted | Dynamic Definition | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
operand1
|
C | S | A | yes | no | |||||||||||||||
operand2
|
S | I | yes | no | ||||||||||||||||
operand3
|
C | S | A | A | N | P | I | F | B | D | T | L | C | G | O | yes | no |
Syntax Element Description:
Syntax Element | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
operand1
|
Event Name:
|
||||||||||
operand2 |
Dialog Identifier:
|
||||||||||
operand3
|
Parameters to be Passed:
It is possible to pass parameters to the dialog. See WITH PARAMETERS Clause below. |
||||||||||
AD=
|
|
||||||||||
nX
|
Parameters to be Skipped:
With the notation
A parameter that is to be skipped must be defined with the
keyword |
||||||||||
USING DIALOG
dialog-name |
Dialog Name:
Name of the dialog receiving the user event. |
With this clause, parameters may be passed to the dialog selectively.
Note:
You can only use this clause if the specified target dialog
specified in dialog-name
is cataloged.
WITH
PARAMETERS {parameter-name=operand3}
|
END-PARAMETERS
|
Syntax Element Description:
Syntax Element | Description |
---|---|
parameter-name=operand3 |
Parameters:
As Note: |
END-PARAMETERS |
End of PARAMETERS Clause:
The Natural reserved word |