RealizePalette

RealizePalette 関数は、現在の論理パレットのパレットエントリをシステムパレットにマッピングする。

RealizePalette hdc

hdc : [intptr] 論理パレットが選択されているデバイスコンテキストへのハンドル。

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

解説

RealizePalette 関数は、現在の論理パレットのパレットエントリをシステムパレットにマッピングする。

[戻り値]
関数が成功した場合、戻り値はシステムパレットにマッピングされた論理パレット内のエントリ数である。関数が失敗した場合、戻り値は
GDI_ERROR である。

[備考]
アプリケーションは、GetDeviceCaps 関数を呼び出して RASTERCAPS
定数を指定することで、デバイスがパレット操作をサポートしているかを判定できる。RealizePalette
関数は、指定したデバイスコンテキストに関連付けられたデバイスのパレットを変更する。デバイスコンテキストがメモリ DC の場合、DC
に選択されたビットマップのカラーテーブルが変更される。デバイスコンテキストがディスプレイ DC
の場合、そのデバイスの物理パレットが変更される。論理パレットは、カラーを多用するアプリケーションとシステムとの間のバッファとして機能し、これらのアプリケーションが他のウィンドウで表示される色と干渉することなく、必要なだけの色を使用できるようにする。アプリケーションのウィンドウがフォーカスを持ち、RealizePalette
関数を呼び出すと、システムは要求された色のうちできるだけ多くを実現しようとする。アクティブでないウィンドウを持つアプリケーションについても同様である。

情報