描述
UpdateColors功能通过将客户区中的当前颜色重新映射到当前实现的逻辑调色板来更新指定设备上下文的客户区。
C++ 语法
BOOL UpdateColors( __in HDC hdc ); |
PowerBASIC 语法
FUNCTION UpdateColors ( _ BYVAL hdc AS DWORD _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展的错误信息，请调用GetLastError.
备注
应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。
具有实现的逻辑调色板的不活动窗口可以调用UpdateColors作为在系统调色板更改时重新绘制其客户区域的替代方法。
UpdateColors功能通常比重新绘制区域更快地更新客户区。但是，由于UpdateColors在系统调色板更改之前，基于每个像素的颜色执行颜色转换，因此每次调用此函数会导致某些颜色精度的损失。
必须在接收到WM_PALETTECHANGED消息后立即调用此函数。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）