PROCESS GUI

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

This document covers the following topics:

Function
Syntax Description

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.