Instance Method

willPresentError(_:)

Called when the receiver is about to present an error.

Declaration

func willPresentError(_ error: Error) -> Error

Parameters

error

The error object that is about to be presented to the user.

Return Value

The error that should actually be presented.

Discussion

The default implementation of this method merely returns the passed-in error. The returned error may simply be forwarded to the document controller.

You can override this method to customize the presentation of errors by examining the passed-in error and, for example, returning more specific information. When you override this method always check the NSError object’s domain and code to discriminate between errors whose presentation you want to customize and those you don’t. For errors you don’t want to customize, call the superclass implementation, passing the original error.

See Also

Handling Errors

func presentError(Error) -> Bool

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

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.