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

GXIgnoreGraphicsWarning

You can use the GXIgnoreGraphicsWarning function to ignore warnings.

void GXIgnoreGraphicsWarning(gxGraphicsWarning warning);

warning

The warning number or warning name to ignore.

DESCRIPTION

The GXIgnoreGraphicsWarning function adds the warning to be ignored to the ignore warning stack. The posting of warnings is suppressed for all warnings on the ignore warning stack. Warnings may be removed from the ignore warnings stack by the use of the GXPopGraphicsWarning function.

You may use any Quickdraw GX warning numbers and warning names or, if you have installed an application-defined warning handler, you may use your own warning numbers and warning names, as long as they use a numbering system different than that provided by QuickDraw GX.

SPECIAL CONSIDERATIONS

The GXIgnoreGraphicsWarning function saves warning numbers in a warning stack of limited size, so that a limited number of warnings can be ignored at one time. If the GXIgnoreGraphicsWarning function has been called too many times with no matching calls to the GXPopGraphicsWarning function, subsequent calls to the GXIgnoreGraphicsWarning function do not cause the warning to be ignored and a warning_stack_overflow warning is posted.

ERRORS, WARNINGS, AND NOTICES

Warnings

warning_stack_overflow

SEE ALSO

The use of this function is described in the section "Ignoring Warnings and Notices" beginning on page 3-36.

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

The GXPopGraphicsWarning function is described in the next section.