| Prev | Next | Basic Verbs > complexEvent |
complexEvent
| Syntax |
complexEvent (tableAddr, appID, verbClass, verbID [, key1, value1 [..., keyN, valueN]])
|
| Params |
tableAddr 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. The address of a binary code value may also be supplied (see Notes). verbClass is a string4 indicating the Apple event verb class. verbID is a string4 indicating the Apple event verb ID. 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 class and ID to the application identified by appID, one parameter for each keyN, valueN pair provided, and waits for a reply. Each value in the reply is then added to the table at tableAddr, 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 |
complexEvent (@scratchpad.complexResult, 'BARC', 'app1', 'cwin') » true
A table has been created at scratchpad.complexResult, containing a single item named "----" that is a boolean value true. If BarChart's reply contained more than one item, the table would contain additional values. |
| 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 |
Any number of key, value parameter pairs may be provided, including zero (none). Any key, value pair can be replaced by a table name. The values in the table will be included in the event, with the item names as the parameter keys. The item names must all be four characters long. In Frontier 3.0 or above, a key, value pair can be replaced by a record value. The values in the record will be included in the event, with the record keys as the parameter keys. The type of each parameter value determines the corresponding descriptor type in the outgoing Apple event. The key of each item in the result determines the name of the corresponding table item, and the descriptor type determines the type of the value. In addition to sending Apple Events to other applications, this verb can be used to call a UCMD or OSA Script by passing the object's database address as the appID parameter.
|
| See Also |
appleEvent
|
| Prev | Next | Basic Verbs > complexEvent |
