UpdateColors

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

UpdateColors hdc

hdc : [intptr] デバイスコンテキストへのハンドル。

(プラグイン / モジュール : gdi32.dll)

解説

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

[戻り値]
関数が成功した場合、戻り値は非ゼロである。関数が失敗した場合、戻り値はゼロである。

[備考]
アプリケーションは、GetDeviceCaps 関数を呼び出して RASTERCAPS
定数を指定することで、デバイスがパレット操作をサポートしているかを判定できる。実現された論理パレットを持つ非アクティブなウィンドウは、システムパレットが変更されたときにクライアント領域を再描画する代わりに
UpdateColors を呼び出すことができる。UpdateColors
関数は通常、領域の再描画よりも速くクライアント領域を更新する。ただし、UpdateColors
はシステムパレットが変更される前の各ピクセルの色に基づいてカラー変換を実行するため、この関数を呼び出すたびに色精度の一部が失われる。この関数は
WM_PALETTECHANGED メッセージを受信した直後に呼び出さなければならない。

情報