UpdateColors 関数 (wingdi.h)

UpdateColors 関数は、クライアント領域の現在の色を現在実現されている論理パレットに再マップすることで、指定されたデバイスコンテキストのクライアント領域を更新します。

構文

BOOL UpdateColors(
  [in] HDC hdc
);

[in] hdc

デバイスコンテキストへのハンドル。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

アプリケーションは、 GetDeviceCaps 関数を呼び出し、RASTERCAPS 定数を指定することで、デバイスがパレット操作をサポートしているかどうかを判断できます。

論理パレットが実現された非アクティブなウィンドウでは、システムパレットが変更されたときにクライアント領域を再描画する代わりに UpdateColors を呼び出す場合があります。

UpdateColors 関数は、通常、領域を再描画するよりも速くクライアント領域を更新します。ただし、 UpdateColors では、システムパレットが変更される前の各ピクセルの色に基づいて色変換が実行されるため、この関数を呼び出すたびに、色の精度が失われます。

この関数は、 WM_PALETTECHANGED メッセージを受信した直後に呼び出す必要があります。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll