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

GXPostGraphicsWarning

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

void GXPostGraphicsWarning(gxGraphicsWarning warning);

warning

The warning to be posted.

DESCRIPTION

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.

SPECIAL CONSIDERATIONS

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.

SEE ALSO

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.