Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: QuickDraw GX Environment and Utilities /
Chapter 3 - Errors, Warnings, and Notices / Errors, Warnings, and Notices Reference
Functions / Notice Posting and Handling


You can use the GXPostGraphicsNotice function to post your own notices from inside your application.

void GXPostGraphicsNotice(gxGraphicsNotice notice);
The notice to be posted.
The GXPostGraphicsNotice function replaces the QuickDraw GX notice about to be posted with a notice message defined by the notice parameter.

You may use the QuickDraw GX notices or define your own notice number and notice name. This function stores the posted notice so that subsequent calls to the GXGetGraphicsNotice function return the notice substituted by this function.

If the notice to be posted is in the ignore notice stack, the notice is not posted and execution continues. Ignoring notices is discussed in the section "Ignoring Warnings and Notices" beginning on page 3-36.

If an application-defined notice handler is provided, the notice is passed to the handler.

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

The notice number must be within the range defined by QuickDraw GX. This range is bounded by notice numbers -25999 through -25500 or is in an application range.

The use of this function is described in the section "Changing the Error, Warning, or Notice Posted" beginning on page 3-34.

Notice handlers are discussed in the section "Installing an Error, Warning, or Notice Handler" beginning on page 3-38.

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996