Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

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

Application-Defined Functions /

MyUserGraphicsNotice

You can use the MyUserGraphicsNotice function to provide an application-defined notice handler for your application.

void MyUserGraphicsNotice(gxGraphicsNotice notice, 
                           long reference);

notice

The QuickDraw GX notice being passed to the handler.

reference

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

DESCRIPTION

The MyUserGraphicsNotice function is called with the notice number posted by the defective function. The MyUserGraphicsNotice function can evaluate the notice and respond in any appropriate manner.

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

The GXGetUserGraphicsNotice function returns the currently installed application-defined notice handler. This function will never be called in the non-debugging version of QuickDraw GX.

SEE ALSO

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

Notices that may be sent to the notice handler are listed in the section "Notices" beginning on page 3-27.

The GXSetUserGraphicsNotice function is described on page 3-66.

The GXGetUserGraphicsNotice function is described on page 3-67.