| Prev | Next | Basic Verbs > getEventAttribute |
getEventAttribute
| Syntax |
getEventAttribute (keyword)
|
| Params |
keyword is a string4 identifying the event attribute to be retrieved.
|
| Action |
Extracts the attribute identified by keyword from the event that is being handled by the current script.
|
| Returns |
The value of the requested attribute.
|
| Examples |
getEventAttribute ('addr') «get the sender of this event » (a binary result)
The binary result contains the address of the sender. See Notes.
The result indicates that the interact level is "can interact" |
| Errors |
This verb will generate an error if called from a script that is not running as a trap, responding to an Apple event sent to Frontier. If keyword is not a valid attribute value, an error will occur.
|
| Platform Notes |
This verb is only implemented in the Mac OS version of Frontier.
|
| Notes |
This is an advanced verb that retrieves low-level information about the Apple event that invoked the currently-running trap script. The type of value returned depends on the descriptor type of the particular attribute. If it corresponds to one of Frontier's built-in types, a value of that type is returned. Otherwise, it is a binary value whose binaryType is the descriptor type. The binary value returned for the target address attribute ('addr') can be used as the appID parameter in any appleEvent or other IAC message verb. The valid values for keyword are documented in the Apple Event Manager chapter of Inside Macintosh, Volume VI (Addison Wesley).
|
| Prev | Next | Basic Verbs > getEventAttribute |
