Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 19 - Error Manager / Error Manager Reference

Application-Defined Routines /

TQ3NoticeMethod

You can define a function to handle notices that occur during the execution of QuickDraw 3D routines.

typedef void (*TQ3NoticeMethod) (
TQ3Notice firstNotice, 
TQ3Notice lastNotice, 
long reference);

firstNotice

A code that indicates the first notice that occurred since the last time your notice-handling function was called.

lastNotice

A code that indicates the most recent notice that occurred.

reference

A long integer for your application's own use.

DESCRIPTION

Your TQ3NoticeMethod function is called whenever a QuickDraw 3D routine generates a notice during its execution that QuickDraw 3D cannot handle internally. Your notice-handling function should handle the notice conditions indicated by the firstNotice and lastNotice parameters. Your function must not call any QuickDraw 3D routines. The reference parameter contains the long integer that you passed to Q3Notice_Register when you registered your notice handler. You can, for example, use that long integer to point to any data required by your notice handler.