Presents an error alert to the user as a document-modal sheet attached to document window.
- macOS 10.4+
The object encapsulating information about the error.
The window object identifying the window owning the document-modal sheet.
The modal delegate for the sheet.
A selector identifying the message to be sent to the modal delegate. The
didselector must have the signature:
Supplemental data to be passed to the modal delegate; can be
The information displayed in the alert is extracted from the
error; it may include a description, recovery suggestion, failure reason, and button titles (all localized). Once the user dismisses the alert and any recovery attempter associated with the error object has had a chance to recover from it, the receiver sends a message identified by
did to the modal delegate
delegate. (A recovery attempter is an object that conforms to the NSErrorRecoveryAttempting informal protocol.)
The modal delegate implements the method identified by
did to perform any post-error processing if recovery failed or was not attempted (that is,
NO). Any supplemental data is passed to the modal delegate via
The default implementation of this method sends
self. By doing this,
NSResponder gives subclasses an opportunity to customize error presentation. It then forwards the message, passing any customized error to the next responder or, if there is no next responder, it passes the error object to
NSApp, which displays a document-modal error alert. When the user dismisses the alert, any recovery attempter associated with the error object is given a chance to recover from the error. See the class description for the precise route up the responder chain (plus document and controller objects) this message might travel.
It is not recommended that you attempt to override this method. If you wish to customize the error presentation, override