Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 3 - Errors, Warnings, and Notices / Errors, Warnings, and Notices Reference

Functions / Error Posting and Handling

GXPostGraphicsError

You can use the GXPostGraphicsError function to replace the current QuickDraw GX error with another error.

void GXPostGraphicsError(gxGraphicsError error);

error

The error to be posted.

DESCRIPTION

The GXPostGraphicsError function replaces the QuickDraw GX error about to be posted with an error message defined by the error parameter. You may use the QuickDraw GX errors or define your own error number and error name. This function stores the error posted so that subsequent calls to the GXGetGraphicsError function return the error substituted by this function.

The GXPostGraphicsError function is available only when the debugging version is installed.

SPECIAL CONSIDERATIONS

The error number must be within the range defined by QuickDraw GX. This range is bounded by error numbers -27999 through -27000, or is in the 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.

Non-debugging errors that can be replaced are listed in the section "Errors" beginning on page 3-6. Non-debugging errors that can be replaced are listed in the section "Errors" beginning on page 3-6.