The SetPaletteEntries function sets RGB (red, green, blue) color values and flags in a range of entries in a logical palette.
UINT SetPaletteEntries(
| HPALETTE hpal, | // handle of logical palette |
| UINT iStart, | // index of first entry to set |
| UINT cEntries, | // number of entries to set |
| CONST PALETTEENTRY *lppe | // address of array of structures |
| ); |
Parameters
hpal
Identifies the logical palette.
iStart
Specifies the first logical-palette entry to be set.
cEntries
Specifies the number of logical-palette entries to be set.
lppe
Points to the first member of an array of PALETTEENTRY structures containing the RGB values and flags.
Return Values
If the function succeeds, the return value is the number of entries that were set in the logical palette.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
An application can determine whether or not a device supports palette operations by calling the GetDeviceCaps function and specifying the RASTERCAPS constant.
Even if a logical palette has been selected and realized, changes to the palette do not affect the physical palette in the surface. RealizePalette must be called again to set the new logical palette into the surface.
See Also
GetDeviceCaps, GetPaletteEntries, RealizePalette, PALETTEENTRY