PALETTERGB

Version 3.0

Syntax

COLORREF PALETTERGB(cRed, cGreen, cBlue)

This macro accepts three values representing relative intensities of red, green, and blue, and returns a value consisting of 2 in the high-order byte and an RGB value in the three low-order bytes. This is called a palette-relative RGB specifier. An application using a color palette can pass this specifier instead of an explicit RGB value to functions that expect a color.

For output devices that support logical palettes, Windows matches a palette-relative RGB value to the nearest color in the logical palette of the device context, as though the application had specified an index to that palette entry. If an output device does not support a system palette, then Windows uses the palette-relative RGB as though it were a conventional RGB DWORD returned by the RGB macro.

Parameter Type/Description  

cRed BYTE Specifies the intensity of the red color field.  
cGreen BYTE Specifies the intensity of the green color field.  
cBlue BYTE Specifies the intensity of the blue color field.  

Return Value

The return value specifies a palette-relative RGB value.