CreatePalette function (wingdi.h)
The CreatePalette function creates a logical palette.
Syntax
HPALETTE CreatePalette(
[in] const LOGPALETTE *plpal
);
Parameters
[in] 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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | wingdi.h (include Windows.h) |
| Library | Gdi32.lib |
| DLL | Gdi32.dll |