PROCESS GUI

 

operand1

 
PROCESS GUI ACTION action-name   WITH nX [GIVING operand2]
  PARAMETERS-clause  

This document covers the following topics:

Related Statement: OPEN DIALOG | CLOSE DIALOG | SEND EVENT

Belongs to Function Group: Event-Driven Programming


Function

The PROCESS GUI statement is used to perform an action. An action in this context is a procedure frequently needed in event-driven applications.

For general information on these standard procedures, see Event-Driven Programming Techniques (in the Programming Guide).

For information on the individual actions available, their parameters, and examples, see PROCESS GUI Statement Actions (in the Dialog Component Reference).

Syntax Description

Operand Definition Table:

Operand Possible Structure Possible Formats Referencing Permitted Dynamic Definition
operand1* C S A     A U N P I F B D T L   G   yes no
operand2   S           N P I                 yes no

* The structure and format actually possible depend on the action to be performed.

Syntax Element Description:

Syntax Element Description
action-name
Action to Be Invoked:

As action-name, you specify the name of the action to be invoked.

operand1
Passing Parameters to the Action:

As operand1, you specify the parameter(s) to be passed to the action. The parameters are passed in the sequence in which they are specified.

PARAMETERS See Passing Parameters by Name below.
nX
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 action. This is only possible for actions which are applied to ActiveX controls.

A parameter that is to be skipped must be defined as "optional" in the ActiveX control's method. If a parameter is defined as "optional", this means that a value can - but need not - be passed from the invoking object to such a parameter.

GIVING operand2
Field for Response Code:

As operand2, you can specify a field to receive the response code from the invoked action after the action has been performed.

Passing Parameters by Name:

For the action ADD, you can also pass parameters by name (instead of position); to do so, you use the PARAMETERS-clause:

PARAMETERS {parameter-name=operand1}
END-PARAMETERS

This clause can only be used for the action ADD, not for any other action.

If the action has optional parameters (that is, parameters that need not to be specified), you can use the notation nX as a placeholder for n not specified parameters. Currently, the only actions that can have optional parameters are the methods and the parameterized properties of ActiveX controls.