CreatePalette function

The CreatePalette function creates a logical palette.

Syntax

HPALETTE CreatePalette(
  CONST LOGPALETTE *plpal
);

Parameters

plpal

A pointer to a LOGPALETTE structure that contains information about the colors in the logical palette.

Return Value

If the function succeeds, the return value is a handle to a logical palette.

If the function fails, the return value is NULL.

Remarks

An application can determine whether a device supports palette operations by calling the GetDeviceCaps function and specifying the RASTERCAPS constant.

Once an application creates a logical palette, it can select that palette into a device context by calling the SelectPalette function. A palette selected into a device context can be realized by calling the RealizePalette function.

When you no longer need the palette, call the DeleteObject function to delete it.

Requirements

   
Windows version Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See Also

Color Functions

Colors Overview

DeleteObject

GetDeviceCaps

LOGPALETTE

RealizePalette

SelectPalette