SelectPalette 関数 (wingdi.h)

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 に設定する必要があります。

要件

こちらもご覧ください

カラー関数

色の概要

CreateCompatibleDC

CreatePalette

GetDeviceCaps

RealizePalette