Framework | /System/Library/Frameworks/ScriptingBridge.framework |
Availability | Available in Mac OS X v10.6 and later. |
Declared in | SBApplication.h |
This informal protocol defines a delegation method for handling Apple event errors that are sent from an target application to an SBApplication
object.
You must set a delegate for the SBApplication
object using the setDelegate:
method. If you do not set a delegate and have the delegate handle the error in some way, SBApplication
raises an exception.
Sent by an SBApplication
object when a target application returns an error Apple event. (required)
- (void)eventDidFail:(const AppleEvent *)event withError:(NSError *)error
A pointer to the Apple event sent to the target application causing the error.
An object containing information about the error Apple event. Specific information may be included in the useInfo
dictionary of the error object. See “User Info Dictionary Keys”
for a list of possible keys for this dictionary.
SBApplication.h
The following describes the possible keys for the userInfo
dictionary of the NSError
object passed to the delegate. Note that for some errors, the userInfo
dictionary may not have any of these keys.
@"ErrorBriefMessage"
A short human-readble description of the error, as an NSString
object.
@"ErrorExpectedType"
The type of data the target application expected, as an NSAppleEventDescriptor
object.
@"ErrorOffendingObject"
The object that caused the error.
@"ErrorString"
A full human-readable description of the error, as an NSString
object.
@"ErrorNumber"
The Apple event error number, as an NSNumber
object.
ScriptingBridge/SBApplication.h
Last updated: 2007-05-29