PROCESS GUI

#### Search Results

Search

# PROCESS GUI

|  |  | operand1 |  |  |
`PROCESS GUI ACTION` action-name `WITH` | n `X` | [`GIVING` operand2]
| PARAMETERS-clause |

This document covers the following topics:

- PROCESS GUI Usage

- PROCESS GUI Syntax Description

Related Statement: `OPEN DIALOG` | `CLOSE DIALOG` | `SEND EVENT`

Belongs to Function Group: Event-Driven Programming

## PROCESS GUI Usage

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).

## PROCESS GUI 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.

### On this page

- PROCESS GUI Usage
- PROCESS GUI Syntax Description