updateColors 函式 (wingdi.h)
UpdateColors函式會將工作區重新對應至目前實現的邏輯調色盤,以更新指定裝置內容的工作區。
語法
BOOL UpdateColors(
[in] HDC hdc
);
參數
[in] hdc
裝置內容的控制碼。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。
備註
應用程式可以呼叫 GetDeviceCaps 函式並指定 RASTERCAPS 常數,來判斷裝置是否支援調色盤作業。
具有具現化邏輯調色盤的非使用中視窗,可以在系統調色盤變更時,呼叫 UpdateColors 作為重新繪製其工作區的替代方案。
UpdateColors 函式通常會比重繪區域更快更新工作區。 不過,由於 UpdateColors 會根據系統調色盤變更前每個圖元的色彩執行色彩轉譯,因此每次呼叫此函式會導致遺失某些色彩精確度。
收到 WM_PALETTECHANGED 訊息之後,必須立即呼叫此函式。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |