PALETTEENTRY

This structure specifies the color and usage of a logical palette entry. A logical palette is defined by a LOGPALETTE structure.

typedef struct tagPALETTEENTRY {
  BYTE peRed;
  BYTE peGreen;
  BYTE peBlue;
  BYTE peFlags;
} PALETTEENTRY; 

Members

• peRed
  Specifies a red intensity value for the palette entry.
• peGreen
  Specifies a green intensity value for the palette entry.
• peBlue
  Specifies a blue intensity value for the palette entry.
• peFlags
  Specifies how the palette entry is to be used. The peFlags member may be set to NULL or one of the following values.

  Value	Description
  PC_EXPLICIT	Specifies that the low-order word of the logical palette entry designates a hardware palette index. This flag allows the application to show the contents of the display device palette.
  PC_NOCOLLAPSE	Specifies that the color be placed in an unused entry in the system palette instead of being matched to an existing color in the system palette. If there are no unused entries in the system palette, the color is matched normally. Once this color is in the system palette, colors in other logical palettes can be matched to this color.
  PC_RESERVED	Specifies that the logical palette entry be used for palette animation. This flag prevents other windows from matching colors to the palette entry because the color frequently changes. If an unused system-palette entry is available, the color is placed in that entry. Otherwise, the color is not available for animation.

Remarks

Window CE ignores the peFlags member. It should be initialized to 0.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Windows.h.

See Also

CreatePalette | LOGPALETTE | GDI Structures

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.