UpdateColors函式通過把客戶區域的當前顏色重新映射到之前被映射過的邏輯調色板,來更新指定設備環境的客戶區域。
基本介紹
- 中文名:UpdateColors
- Windows NT:3.1及以上版本
- Windows:95及以上版本
- Windows CE:不支持
函式原型,參數,
函式原型
BOOL UpdateColors(HDC hdc);
參數
hdc:設備環境句柄。
返回值:如果成功返回值非零,如果失敗,返回值為零。
Windows NT:若想獲得更多錯誤信息,請調用GetLastError函式。
注釋:通過調用GetDeviceCaps函式和設定RASTERCAPS常量,一個套用可以確定一個設備是否支持調色板操作,當系統調色板發生變化時,一個映射邏輯調色板非活動視窗可以通過調用Updatecolors,作為一種選擇方法刷新它的客戶區域。
UpdateColors函式更新一個客戶區域比刷新該區域要快,但是,由於在系統調色板改變之前UpdateColors函式要進行基於每個像素顏色的色彩轉換,因此,每一次調用該函式會導致一些顏色失真。
一旦收到WM_PALETTECHANGED訊息,該函式必須馬上被調用。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:wingdi.h;庫檔案:gdi32.lib。