Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 3 - QuickDraw Drawing / QuickDraw Drawing Reference

Routines / Customizing QuickDraw Operations

StdComment

The StdComment procedure is QuickDraw's standard low-level routine for processing a picture comment.

PROCEDURE StdComment (kind,dataSize:\xDDInteger; 
                      dataHandle:\xDDHandle);

kind

The type of comment. See Appendix A in this book for a list of the standard constants (and the values they represent) used to specify common picture comment types.

dataSize

The size of additional data.

dataHandle

A handle to additional data.

DESCRIPTION

The kind parameter identifies the type of comment. The dataHandle parameter takes a handle to additional data, and the dataSize parameter specifies the size of that data in bytes. If there's no additional data for the comment, the value of the dataHandle parameter is NIL and the value of the dataSize parameter is 0. The StdComment procedure simply ignores the comment.

SPECIAL CONSIDERATIONS

The StdComment procedure may move or purge memory blocks in the application heap. Your application should not call this procedure at interrupt time.

SEE ALSO

Picture comments are described in detail in Appendix B, "Using Picture Comments for Printing."