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

另请参阅

颜色函数

颜色概述

CreatePalette

GetDeviceCaps

SelectPalette