Instance Method

presentError(_:modalFor:delegate:didPresent:contextInfo:)

Presents an error alert to the user as a modal panel.

Declaration

func presentError(_ error: Error, modalFor window: NSWindow, delegate: Any?, didPresent didPresentSelector: Selector?, contextInfo: UnsafeMutableRawPointer?)

Parameters

error

The error object encapsulating the information to present to the user.

window

The window to which the modal alert belongs.

delegate

The delegate to which the selector message is sent.

didPresentSelector

The selector of the message sent to the delegate.

contextInfo

Object passed with the callback to provide any additional context information.

Discussion

When the user dismisses the alert and any recovery possible for the error and chosen by the user has been attempted, sends the message didPresentSelector to the specified delegate.

The NSDocument default implementation of this method is equivalent to that of NSResponder and treats the shared NSDocumentController object as the next responder and forwards these messages to it. The default implementations of several NSDocument methods invoke this method.

The default implementation of this method invokes willPresentError(_:) to give subclasses an opportunity to customize error presentation. You should not override this method but should instead override willPresentError(_:).

The method selected by didPresentSelector must have the same signature as:

- (void)didPresentErrorWithRecovery:(BOOL)didRecover contextInfo:(void  *)contextInfo

See Also

Handling Errors

func presentError(Error) -> Bool

Presents an error alert to the user as a modal panel.

func willPresentError(Error) -> Error

Called when the receiver is about to present an error.

func willNotPresentError(Error)

Confirms that the given NSError object is not to be presented to the user and the error cannot be recovered from, so that cleanup can be done.