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 |