RealizePalette 函数 (wingdi.h)

RealizePalette 函数将调色板条目从当前逻辑调色板映射到系统调色板。

语法

UINT RealizePalette(
  [in] HDC hdc
);

[in] hdc

已在其中选择逻辑调色板的设备上下文的句柄。

如果函数成功，则返回值是映射到系统调色板的逻辑调色板中的条目数。

如果函数失败，则返回值GDI_ERROR。

应用程序可以通过调用 GetDeviceCaps 函数并指定 RASTERCAPS 常量来确定设备是否支持调色板操作。

RealizePalette 函数修改与指定设备上下文关联的设备的调色板。如果设备上下文是内存 DC，则会修改所选到 DC 中的位图的颜色表。如果设备上下文是显示 DC，则会修改该设备的物理调色板。

逻辑调色板是颜色密集型应用程序和系统之间的缓冲区，允许这些应用程序根据需要使用任意数量的颜色，而不会干扰其他窗口显示的颜色。

当应用程序的窗口具有焦点并调用 RealizePalette 函数时，系统会尝试实现尽可能多的请求颜色。对于具有非活动窗口的应用程序也是如此。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll