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

GXPostGraphicsNotice

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

void GXPostGraphicsNotice(gxGraphicsNotice notice);

notice

The notice to be posted.

DESCRIPTION

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.

SPECIAL CONSIDERATIONS

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.

SEE ALSO

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.