Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 3 - Errors, Warnings, and Notices / Errors, Warnings, and Notices Reference

Application-Defined Functions /

MyUserGraphicsError

You can use the MyUserGraphicsError function to provide an application-defined error handler for your application.

void MyUserGraphicsError(gxGraphicsError error, long reference);

error

The QuickDraw GX error being passed to the handler.

reference

A long value passed each time that an error occurs. This value can be used by the error handler for any purpose.

DESCRIPTION

The MyUserGraphicsError function is called with the error number posted by the failed function. The MyUserGraphicsError function can evaluate the error and respond in any appropriate manner.

The error handler is enabled and disabled by the use of the GXSetUserGraphicsError function. If its parameter is set to nil, the error handler is disabled. If its parameter is not nil, the error handler is enabled and all errors detected by QuickDraw GX are passed to the error handler for processing and possible response.

The GXGetUserGraphicsError function returns the currently installed application-defined error handler.

SEE ALSO

The use of this function is described in the section "Installing an Error, Warning, or Notice Handler" on page 3-38.

QuickDraw GX non-debugging errors that may be sent to the error handler are listed in section "Errors" beginning on page 3-6. Debugging errors are listed in the section "Errors" beginning on page 3-6.

The GXSetUserGraphicsError function is described on page 3-56.

The GXGetUserGraphicsError function is described on page 3-57.