CDC::RealizePalette

RealizePalette

函数功能：该函数从当前逻辑调色板中映射调色板入口点到系统调色板中。

函数原型：UINT RealizePalette(HDC hdc)；

参数：

hdc：设备环境句柄。一个逻辑调色板被选择在该设备环境中。

返回值：如果函数成功，函数返回值定义口点的数目，这些逻辑调色板中的入口点映射到系统调色板中；如果失败，返回值是GDI＿ERROR。

 CDC::RealizePalette

Maps entries from the current logical palette to the system palette. 返回从当前逻辑调色板映射到系统调色板的入口点的个数。

UINT RealizePalette( );

 Return Value 返回值

Indicates how many entries in the logical palette were mapped to different entries in the system palette. This represents the number of entries that this function remapped to accommodate changes in the system palette since the logical palette was last realized.

 Remarks

A logical color palette acts as a buffer between color-intensive applications and the system, allowing an application to use as many colors as needed without interfering with its own displayed colors or with colors displayed by other windows.

逻辑颜色调色板是颜色密集型应用和系统之间的一个缓存，允许这些应用在不干扰其他窗口颜色的情况下使用任意多的颜色。

When a window has the input focus and calls RealizePalette, Windows ensures that the window will display all the requested colors, up to the maximum number simultaneously available on the screen. Windows also displays colors not found in the window's palette by matching them to available colors.

当焦点在一个应用窗口，并且它调用RealizePalette函数时，则系统试图映射尽可能多的颜色，这对于活动窗口的应用也同样正确。

In addition, Windows matches the colors requested by inactive windows that call the function as closely as possible to the available colors. This significantly reduces undesirable changes in the colors displayed in inactive windows.

 Requirements

Header: afxwin.h