SelectPalette 関数 (wingdi.h)

[アーティクル]
08/27/2023

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

構文

HPALETTE SelectPalette(
  [in] HDC      hdc,
  [in] HPALETTE hPal,
  [in] BOOL     bForceBkgd
);

パラメーター

[in] hdc

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

[in] hPal

選択する論理パレットのハンドル。

[in] bForceBkgd

論理パレットを強制的に背景パレットにするかどうかを指定します。この値が TRUE の場合、 RealizePalette 関数を使用すると、論理パレットが物理パレットに既に存在する色に最適な方法でマップされます。これは、パレットが認識されるウィンドウがアクティブフォーカスのないスレッドに属している場合でも、常に行われます。

この値が FALSE の場合、アプリケーションがフォアグラウンドにあるときに、RealizePalette によって論理パレットがデバイスパレットにコピーされます。 ( hdc パラメーターがメモリデバイスコンテキストの場合、このパラメーターは無視されます)。

戻り値

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

関数が失敗した場合は、返される値は NULL です。

注釈

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

アプリケーションは、デバイスコンテキストに互換性がある場合にのみ、複数のデバイスコンテキストに論理パレットを選択できます。それ以外の場合 、SelectPalette は失敗します。別のデバイスコンテキストと互換性のあるデバイスコンテキストを作成するには、最初のデバイスコンテキストをパラメーターとして CreateCompatibleDC を呼び出します。論理パレットが複数のデバイスコンテキストに選択されている場合、論理パレットに対する変更は、選択されているすべてのデバイスコンテキストに影響します。

トップレベルウィンドウの子ウィンドウでそれぞれ独自のパレットが認識される場合、アプリケーションは、bForceBackground パラメーターを TRUE に設定して SelectPalette 関数を呼び出す場合があります。ただし、パレットを実現する必要がある子ウィンドウのみが 、bForceBackground を TRUE に設定する必要があります。他の子ウィンドウでは、この値を FALSE に設定する必要があります。

要件

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