AnimatePalette

  BOOL AnimatePalette(hpal, iStartIndex, cEntries, ppe)    
  HPALETTE hpal; /* handle of logical color-palette */
  UINT iStartIndex; /* first index in logical palette */
  UINT cEntries; /* count of entries in logical palette */
  CONST PALETTEENTRY *ppe; /* address of first replacement */

The AnimatePalette function replaces entries in the given logical palette.

Parameters

hpal

Identifies the logical palette.

iStartIndex

Specifies the first logical-palette entry to be replaced.

cEntries

Specifies the number of entries that should be replaced.

ppe

Points to the first member of an array of PALETTEENTRY structures which are used to replace the current entries. The PALETTEENTRY structure has the following format:

typedef struct tagPALETTEENTRY { /* pe */

BYTE peRed;

BYTE peGreen;

BYTE peBlue;

BYTE peFlags;

} PALETTEENTRY;

Return Value

The return value is TRUE if the function was successful. Otherwise it is FALSE.

Comments

The AnimatePalette function will only change entries with the PC_RESERVED flag set in the corresponding palPaletteEntry member of the LOGPALETTE structure.

If the given palette is associated with the active window, the colors in the palette will be replaced immediately.

See Also

CreatePalette, PALETTEENTRY