transactionEvent
| Syntax |
transactionEvent (appID, verbClass, verbID, transactionID [, key1, value1 [..., keyN, valueN]])
|
| Params |
appID is a value identifying the application to which this verb is addressed. It can be a string4 containing the application signature, a binary value obtained by calling sys.browseNetwork or a string containing the application name or network address. verbClass is a string4 indicating the Apple event verb class. verbID is a string4 indicating the Apple event verb ID. transactionID is a number identifying the transaction of which this verb is a part. key1 is a string4 indicating the keyword for the first parameter value. value1 is the first parameter value, and can be any type. [keyN, valueN] are additional keyword and parameter value pairs.
|
| Action |
Sends an Apple event of the indicated verbClass, with the specified verbID and transactionID, to the application identified by appID, including one parameter for each keyN, valueN pair provided, and waits for a reply.
|
| Returns |
The value contained in the reply from the application. The value can be any type.
|
| Examples |
transactionEvent ("Server", 'misc', 'endt', transID) «send the End Transaction event to the Server » true
|
| Errors |
If the application indicated by appID is not running, or doesn't know how to handle the given verb, an error will occur.
|
| Platform Notes |
This verb is only implemented in the Mac OS version of Frontier.
|
| Notes |
Frontier 3.0 allows the transaction ID of any outgoing message to be set with the setEventTransactionID verb. The transactionID parameter should be a value already agreed upon between the script and the destination application. This is usually established with the misc.beginTransaction verb. Other than the inclusion of the transactionID parameter, this verb is identical to the appleEvent verb. Refer to the documentation for appleEvent for additional Notes.
|
| See Also |
appleEvent
|
