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 / Warning Posting and Handling


You can use the GXPostGraphicsWarning function to post your own warnings from your application.

void GXPostGraphicsWarning(gxGraphicsWarning warning);
The warning to be posted.
The GXPostGraphicsWarning function replaces the QuickDraw GX warning about to be posted with a warning message defined by the warning parameter.

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

If the warning to be posted is in the ignore warning stack, the warning is not posted and execution continues.

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

The warning number must be within the range defined by QuickDraw GX. This range is bounded by warning numbers -26999 through -26000 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.

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

Ignoring warnings is discussed in the section "Ignoring Warnings and Notices" beginning on page 3-36.

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996