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