<<

Contents

Search

>>

 

CALL

 

 

Instruction

 

 

Syntax:

CALL <Program>

 

<Program> = <NAME>

 

or

 

CALL #<Mask Number> [,<Save-ON> [,<Handle>]]

 

<Mask Number> = <NUMBER>

<Save-ON> = <NUM-EXPRESSION>

<Handle> = <NUM-EXPRESSION>

 

Meaning:

CALL <Program> calls an Ebus-J subprogram. It is checked whether an instance of <Program> exists which has finished (i.e. the subprogram has been started once or serveral times and has always finished). If such an instance is found, this instance of the subprogram is started again, otherwise a new instance of the subprogram is created and called. After the called subprogram has finished, program execution continues with the next instruction after CALL.

 

The instruction CALL_INSTANCE  calls always a new instance of the subprogram <Program>.

 

CALL #<Mask Number> calls a mask. With Mask Type Window the mask is displayed in a separate window. WINDOWPOS then specifies the position of the window. After the called mask has been closed with ESC or ENDPROG, program execution continues with the next instruction after CALL #<Mask Number>.

 

If a mask called by CALL # is active, ENDPROG does not end the program but only the CALL of the mask. In a mask called by CALL #... one can jump to another mask by GOTO #... However, this does not lead to a termination of the CALL! The CALL can only be ended with ESC or the instruction ENDPROG.

 

The parameter <Save-ON> specifies, wether the ON <Key> MACROs and/or the ON <Event> MACROs are saved before the mask is called, are reset for the call of the mask and are restored after the call of the mask.

 

<Save-ON>

Meaning

1

The ON <Key> MACROs are saved before the mask is called, are reset for the call of the mask and are restored after the CALL #.

2

The ON <Event> MACROs are saved before the mask is called, are reset for the call of the mask and are restored after the CALL #.

3

The ON <Key> MACROs and the ON <Event> MACROs are saved before the mask is called, are reset for the call of the mask and are restored after the CALL #.

sonst

The ON <Key> MACROs and the ON <Event> MACROs are not changed.

 

<Handle> specifies the higher window (Owner) of the new window. Either the identification number (handle) of a NOWAIT window or 0 can be given. With 0 the main window becomes the Owner of the new window, otherwise the specified window becomes the Owner. If the parameter <Handle> is missing or if the Owner does not exist, the current window becomes the Owner of the new window. If the Owner is closed, the new window is closed as well and with it the mask <Mask Number>.

 

Parameter:

Program

Name of subprogram

Mask Number

Number of Mask

Handle

Owner of  Mask window

 

Sample:

CALL UPROG1

 

CALL #5

 

See also:

CALL_INSTANCE

SHELL

SHELLW

ENDPROG

WINDOWCALL

GOTO

WINDOWPOS

GET_MACROS$

PUT_MACROS