| Prev | Next | Basic Verbs > tableEvent |
tableEvent
| Syntax |
tableEvent (paramsAddr, resultAddr, appID, verbClass, verbID [, key1, value1 [..., keyN, valueN]])
|
| Params |
paramsAddr is the address of a table containing the values to be sent as parameters to the event. resultAddr is the address where the values returned by the destination application are to be stored. 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.
|
| Action |
Sends a Apple event of the indicated class and ID to the application identified by appID, one parameter for each item in the table at paramsAddr, and waits for a reply. Each value in the reply is then added to the table at resultAddr, with each item named according to the value's key in the reply.
|
| Returns |
True if the message is successfully sent; otherwise false. Also fills in the table at tableAddr with the values in the reply.
|
| Examples |
tableEvent (@scratchpad.labelInfo, @scratchpad.result, 'BARC', 'BARC', 'slab') » true
The table scratchpad.labelInfo had been set up to contain the number and label of a column, which became the parameters to the "setBarLabel" verb sent to BarChart. The verb then created a table at scratchpad.result, containing a single item named '----' |
| 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 |
There is no difference between calling tableEvent and calling complexEvent with the table at paramsAddr included in the parameter list. Using this verb highlights the fact that a table is being used as the source for the parameters.
|
| See Also |
appleEvent
|
| Prev | Next | Basic Verbs > tableEvent |