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

GXGetGraphicsNotice

You can use the GXGetGraphicsNotice function to obtain the first and last notices posted.

gxGraphicsNotice GXGetGraphicsNotice
                                 (gxGraphicsNotice *stickyNotice);

stickyNotice

On return, a pointer to the first notice posted.

function result

The last notice posted.

DESCRIPTION

The GXGetGraphicsNotice function returns the last notice posted, or 0 if none. The stickyNotice parameter, if not nil, receives the first notice posted since the last call to the GXGetGraphicsNotice function.

SPECIAL CONSIDERATIONS

QuickDraw GX clears the stickyNotice argument at the end of every call to the GXGetGraphicsNotice function. It always returns 0 on non-debugging versions.

SEE ALSO

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

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

The GXSetUserGraphicsNotice function that is used to install the notice handler is described on page 3-66.