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

GXGetGraphicsWarning

You can use the GXGetGraphicsWarning function to obtain the first and last warning posted.

gxGraphicsWarning GXGetGraphicsWarning
                              (gxGraphicsWarning *stickyWarning);

stickyWarning

On return, a pointer to the first warning posted.

function result

The last warning posted.

DESCRIPTION

The GXGetGraphicsWarning function returns the last warning posted, or 0 if none.

The stickyWarning parameter, if not nil, receives the first warning posted since the last call to the GXGetGraphicsWarning function. QuickDraw GX clears the stickyWarning parameter at the end of every call to the GXGetGraphicsWarning function.

SEE ALSO

The use of this function is described in the section"Obtaining Errors, Warnings, and Notices" beginning on page 3-30.

QuickDraw GX non-debugging warnings that may be posted are listed in the section "Warnings" beginning on page 3-10. Debugging warnings are listed in the section "Warnings" beginning on page 3-10.

An alternative method of posting warnings is to include an application-defined warning handler. This topic is described in the section "Changing the Error, Warning, or Notice Posted" beginning on page 3-34.

The GXSetUserGraphicsWarning function is used to install the warning handler and is described on page 3-60.