SelectPalette

SelectPalette 関数は、指定した論理パレットをデバイスコンテキストに選択する。

SelectPalette hdc, hPal, bForceBkgd

hdc : [intptr] デバイスコンテキストへのハンドル。
hPal : [intptr] 選択する論理パレットへのハンドル。
bForceBkgd : [int] 論理パレットを強制的に背景パレットにするかどうかを指定する。この値が TRUE の場合、RealizePalette 関数は論理パレットを物理パレット内の既存の色にできるだけ良い形でマッピングする。パレットが実現されるウィンドウがアクティブフォーカスを持たないスレッドに属していても、これは常に行われる。この値が FALSE の場合、RealizePalette はアプリケーションがフォアグラウンドにあるときに論理パレットをデバイスパレットにコピーする(hdc パラメータがメモリデバイスコンテキストの場合、このパラメータは無視される)。

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

解説

SelectPalette 関数は、指定した論理パレットをデバイスコンテキストに選択する。

[戻り値]
関数が成功した場合、戻り値はデバイスコンテキストの以前の論理パレットへのハンドルである。関数が失敗した場合、戻り値は NULL である。

[備考]
アプリケーションは、GetDeviceCaps 関数を呼び出して RASTERCAPS
定数を指定することで、デバイスがパレット操作をサポートしているかを判定できる。アプリケーションは、デバイスコンテキストが互換性を持つ場合にのみ、論理パレットを複数のデバイスコンテキストに選択できる。そうでない場合
SelectPalette
は失敗する。別のデバイスコンテキストと互換性のあるデバイスコンテキストを作成するには、最初のデバイスコンテキストを引数として
CreateCompatibleDC
を呼び出す。論理パレットが複数のデバイスコンテキストに選択されている場合、論理パレットへの変更は、それが選択されているすべてのデバイスコンテキストに影響する。トップレベルウィンドウの子ウィンドウがそれぞれ独自のパレットを実現する場合、アプリケーションは
bForceBackground パラメータを TRUE にして SelectPalette
関数を呼び出すことがある。ただし、パレットを実現する必要がある子ウィンドウのみが bForceBackground を TRUE
に設定しなければならず、他の子ウィンドウはこの値を FALSE に設定しなければならない。

情報