Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

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

Functions / Warning Posting and Handling

GXGetUserGraphicsWarning

You can use the GXGetUserGraphicsWarning function to obtain the currently installed application-defined warning handler.

gxUserWarningFunction GXGetUserGraphicsWarning(long *reference);

reference

A long value that gets called each time a warning occurs. This value can be used by your application for any purpose.

function result

A pointer to the installed application-defined warning handler.

DESCRIPTION

The GXGetUserGraphicsWarning function returns a pointer to the function that the application uses to handle warnings. The function returns nil if no application-defined warning handler is provided.

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

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 GXSetUserGraphicsWarning function used to install the warning handler is described in the previous section.

An alternative method to the use of an application-defined warning handler is the use of the QuickDraw GX warnings.

The GXGetGraphicsWarning function, described in the section "Obtaining Errors, Warnings, and Notices" beginning on page 3-30, returns the first and last QuickDraw GX warnings that have been posted.