Microsoft Windows CE 3.0  

PALETTEENTRY

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

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 peFlagsmember 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 peFlagsmember. It should be initialized to 0.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Wingdi.h    
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CreatePalette, LOGPALETTE