Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 6 - Message Manager

The QuickDraw GX Message Manager is a part of the message-passing printing architecture of QuickDraw GX. Read this chapter if you want to use the Message Manager to develop printing extensions or printer drivers.

Because QuickDraw GX uses the Message Manager for printing, you should be familiar with the chapter "Introduction to QuickDraw GX Printing" in Inside Macintosh: QuickDraw GX Printing before reading this chapter.

If you want to use the Message Manager to create printing extensions and printer drivers, you should also read Inside Macintosh: QuickDraw GX Printing Extensions and Drivers.

This chapter introduces the Message Manager as it is used for printing with QuickDraw GX. It then shows how to use Message Manager functions to

• allocate memory for and dispose of global data
• store global data for a single message handler instance
• store global data for multiple message handler instances
• send and forward messages

This chapter also contains reference information for constants, data types, and functions associated with the Message Manager.

---

Chapter Contents

About the Message Manager

Message Terminology

Global Data Storage for Printing Extensions and Printer Drivers

Message Sending and Forwarding

Using the Message Manager

Determining the Version of the Message Manager

Allocating Memory for and Disposing of Global Data

Setting and Getting Global Data for a Single Handler Instance

Setting and Getting Global Data for Multiple Handler Instances

Sending and Forwarding Messages

Message Manager Reference

Constants and Data Types

Message Manager Gestalt Selector

Message Globals Initiatialization Procedure

Functions

Allocating Memory for and Disposing of Global Data

Setting and Getting Global Data for a Single Handler Instance

Setting and Getting Global Data for Multiple Handler Instances

Sending and Forwarding Messages

Driver- or Extension-Defined Functions

Summary of the Message Manager

Constants and Data Types

Message Manager Gestalt Selector

Message Globals Inititialization Procedure

Functions

Allocating Memory for and Disposing of Global Data

Setting and Getting Global Data for Multiple Handler Instances

Setting and Getting Global Data for a Single Handler Instance

Sending and Forwarding Messages

Application-DefinedFunctions

Initializing Memory for Global Data