Specifies an output character string variable that holds the text of any error that occurs while the procedure executes. Declare this as “char errormsg[256].”

Specifies an output parameter that indicates how many frames are registered for the specified event and, consequently, how many events were sent. You must use the & operator. Declare this as “int sent.”

Specifies an obsolete parameter. No values are sent or returned to this variable. Declare this as “char *token.”

Specifies an input parameter that identifies the user event. This event must have been registered by a previous 4GL RegisterUserEvent method. This parameter is case sensitive and must be null terminated. Declare this as “char *eventname.”

Specifies an input parameter that specifies the focus behavior for the current field in the frame. Declare this as “long fb.”

This parameter corresponds to the focusbehavior parameter of the SendUserEvent method for internal events. It lets you trigger the SetValue event or both SetValue and Exit events for the field with the input focus before the external event is triggered. For more information, see Focusbehavior Parameter (see Focusbehavior Parameter).

Valid values for fb are:

These FT constants are defined in the w4glext.h include file.

Specifies an input parameter that specifies a single integer value to be sent to the receiving frame. In the receiving frame, you can access this value with the MessageInteger attribute of the FrameExec object. Declare this as “long msgi4.”

Specifies a return variable that is an output integer variable that indicates the success or failure of the procedure. If the return value is IIW4GL_OK, the send was successful. If the return value is a nonzero value, the send failed (the text of the error message is in errormsg). Declare this as “int status.”