Carbon


RestoreDeviceClut

Header: Palettes.h Carbon status: Supported

Sets the color table of a graphics device to its default state.

void RestoreDeviceClut (
    GDHandle gd
);
Parameter descriptions
gd

A handle to the GDevice structure. Pass NULL in the gdh parameter to restore all screens.

DISCUSSION

The RestoreDeviceClut function changes the color table of the device specified by the gdh parameter to its default state. If this process changes any entries, the Palette Manager posts color updates to windows intersecting the device.

You do not need to use this function to restore the Finder’s desktop colors, because its colors are automatically restored upon switching from applications that use the Palette Manager. Likewise, you need not worry when switching to another application that uses the Palette Manager. Although colors are not automatically restored in this case, if that application needs a certain set of colors, the Palette Manager provides them the moment that application comes to the front.

The reason to use RestoreDeviceClut is that you may be switching to an application that does not use the Palette Manager, in which case that application inherits your palette unless you restore the default color lookup tables for all the available display devices.

VERSION NOTES

The ResizePalette function is available only with system software versions 6.0.5 and later and with the 32-Bit QuickDraw system extension.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)