Legacy Document
Important: The information in this document is obsolete and should not be used for new development.
Important: The information in this document is obsolete and should not be used for new development.
Chapter 3 - Errors, Warnings, and Notices
This chapter describes the errors, warnings, and notices that can be posted by QuickDraw GX functions, and how you can manipulate them. In addition, this chapter describes how you can use application-defined handlers to provide alternative or complementary processing of errors, warnings, and notices. The reference sections of the Inside Macintosh: QuickDraw GX books list the errors, warnings, and notices for each function that they describe.Before reading this chapter, you should be familiar with the information in the chapter "Introduction to QuickDraw GX" in Inside Macintosh: QuickDraw GX Objects.
The errors, warnings, and notices and their related functions that are discussed in this chapter pertain to the graphic and typography parts of QuickDraw GX and do not, in general, apply to printing. For more information on printing errors, see Inside Macintosh: QuickDraw GX Printing and Inside Macintosh: QuickDraw GX Printing Extensions and Drivers.
This chapter starts by introducing you to the errors, warnings, and notices provided in the debugging and non-debugging versions of QuickDraw GX. It then shows you how to use their related functions to
This chapter also contains reference information for all data types, application-defined handlers, and functions associated with QuickDraw GX errors, warnings, and notices.
- obtain the QuickDraw GX errors, warnings, and notices posted
- change the QuickDraw GX errors, warnings, and notices posted
- ignore QuickDraw GX warnings and notices
- install application-defined error, warning, and notice handlers
Chapter Contents
- About QuickDraw GX Errors, Warnings, and Notices
- Non-Debugging Version
- Errors
- Warnings
- Debugging Version
- Errors
- Warnings
- Notices
- Using Errors, Warnings, and Notices
- Obtaining Errors, Warnings, and Notices
- Changing the Error, Warning, or Notice Posted
- Ignoring Warnings and Notices
- Installing an Error, Warning, or Notice Handler
- Errors, Warnings, and Notices Reference
- Constants and Data Types
- Errors
- Warnings
- Notices
- Error, Warning, and Notice Number Ranges
- Functions
- Error Posting and Handling
- Warning Posting and Handling
- Notice Posting and Handling
- Application-Defined Functions
- Summary of Errors, Warnings, and Notices
- Constants and Data Types
- QuickDraw GX Errors
- QuickDraw GX Warnings
- QuickDraw GX Notices
- Application-Defined Handlers
- Functions
- Error Posting and Handling
- Warning Posting and Handling
- Notice Posting and Handling
- Application-Defined Functions