Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 1 - Palette Manager Reference /

Palette Manager Functions / Interacting With the Window Manager

NSetPalette

Associates a new palette with a window; identical to the SetPalette function (page 1-11) except that the nCUpdates parameter is an integer rather than a Boolean value, so that a variety of conditions can trigger an update event.

pascal void NSetPalette(
WindowPtr dstWindow,
                        PaletteHandle srcPalette,
short nCUpdates);

dstWindow

A pointer to the window to which you want to assign a new palette.

srcPalette

A pointer to the palette you want to assign.

nCUpdates

An integer value in which you specify whether the window is to receive updates as a result of various changes to the color environment. See "Update Constants" (page 1-4) for a description of the update options.

DISCUSSION

NSetPalette changes the palette associated with the window specified in the dstWindow parameter to the palette specified by srcPalette. NSetPalette also records whether the window is to receive updates as a result of changes to its color environment. The update constants, which you pass to the nCUpdates parameter, determine when the window is updated.

IMPORTANT

The NSetPalette function is available in system software versions 6.0.2 and later.

SEE ALSO

Use the SetPalette function (page 1-11) if you don't need the flexibility that NSetPalette provides for update events.

Use the GetNewPalette function (page 1-8) or the NewPalette function (page 1-9) to create a new palette.

To dispose of a palette, use the DisposePalette function (page 1-10).