Legacy Document

Inside Macintosh: Imaging With QuickDraw /

Chapter 4 - Color QuickDraw / Color QuickDraw Reference

Color QuickDraw Routines / Reporting Data Structure Changes to QuickDraw

CTabChanged

If you modify the content of a ColorTable record (described on page 4-47), use the CTabChanged procedure.

PROCEDURE CTabChanged (ctab: CTabHandle);

ctab

A handle to the ColorTable record changed by your application.

DESCRIPTION

For the ColorTable record you specify in the ctab parameter, the CTabChanged procedure calls the Color Manager function GetCTSeed to get a new seed (that is, a new, unique identifier in the ctSeed field of the ColorTable record) and notifies Color QuickDraw of the change.

SPECIAL CONSIDERATIONS

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

Your application should never need to directly modify a ColorTable record and use the CTabChanged procedure; instead, your application should use the QuickDraw routines described in this book for manipulating the values in a ColorTable record.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the CTabChanged procedure are

Trap macro	Selector
_QDExtensions	$00040007

SEE ALSO

The GetCTSeed function is described in the chapter "Color Manager" in Advanced Color Imaging on the Mac OS.