Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

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

Functions / Notice Posting and Handling

GXGetUserGraphicsNotice

You can use the GXGetUserGraphicsNotice function to obtain the currently installed application-defined notice handler.

gxUserNoticeFunction GXGetUserGraphicsNotice(long *reference);

reference

A long value that is called each time a notice occurs. This value can be used by the application for any purpose.

function result

A pointer to the installed application-defined notice handler.

DESCRIPTION

The GXGetUserGraphicsNotice function returns a pointer to the function that the application uses to handle notices. The function returns nil if no application-defined notice handler is installed.

If a notice handler function is installed and the reference parameter is not nil, then the reference parameter passed to the GXSetUserGraphicsNotice function is returned.

The GXGetUserGraphicsNotice function has no effect in the non-debugging version.

SEE ALSO

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

The GXSetUserGraphicsNotice function used to install the notice handler is described in the previous section.

An alternative method to the use of an application-defined notice handler is the use of QuickDraw GX notices. The GXGetGraphicsNotice function, described in the section "Obtaining Errors, Warnings, and Notices" beginning on page 3-30, returns the first and last QuickDraw GX notices that have been posted.