From component to program

The gICAPI object implements the following methods:

Table 1. Object methods of gICAPI (component to program)
Name Description
SetData( data STRING ) Data to be sent to the program.
SetFocus() Generates a focus change request.
Action( action STRING ) Triggers an action event.

SetData( data STRING )

Identifies the data to be sent to the program. The corresponding form field value will be updated with data. Data is transmitted as plain text; sending a large amount of data is not recommended. The corresponding form field must be the current one. In the program, only the current field can be updated by the user.

SetFocus()

Generates a focus change request. The focus is entirely managed by the runtime system. The focus request may fail:

If the focus change request succeeds, gICAPI.onFocus() will be called with the true parameter.

Action( action STRING )

Generates an action event, which will trigger the corresponding ON ACTION code. If the named action is not available (not active or does not exist), this function does nothing.