wglSetLayerPaletteEntries 関数 (wingdi.h)
指定したデバイス コンテキストの特定のカラー インデックス レイヤー プレーン内のパレット エントリを設定します。
構文
int wglSetLayerPaletteEntries(
HDC unnamedParam1,
int unnamedParam2,
int unnamedParam3,
int unnamedParam4,
const COLORREF *unnamedParam5
);
パラメーター
unnamedParam1
種類: HDC
レイヤー パレットを設定するウィンドウのデバイス コンテキスト。
unnamedParam2
型: int
オーバーレイまたはアンダーレイ平面。 iLayerPlane の正の値はオーバーレイ平面を識別します。ここで、1 はメイン平面上の最初のオーバーレイ 平面、2 は最初のオーバーレイ プレーン上の 2 番目のオーバーレイ プレーンです。 負の値を指定すると、アンダーレイ平面が識別されます。1 はメイン平面の下の最初の下敷き面、2 は最初のアンダーレイ平面の下の 2 番目のアンダーレイ平面です。 オーバーレイ面とアンダーレイ 平面の数は、PIXELFORMATDESCRIPTOR 構造体の bReserved メンバーで指定されます。
unnamedParam3
型: int
設定する最初のパレット エントリ。
unnamedParam4
型: int
設定するパレット エントリの数。
unnamedParam5
型: const COLORREF*
RGB 色情報を含む cEntries 構造体の配列の最初のメンバーへのポインター。
戻り値
型: int
関数が成功した場合、戻り値は、ウィンドウの指定されたレイヤー プレーン内のパレットで設定されたエントリの数です。 関数が失敗した場合、またはピクセル形式が選択されていない場合、戻り値は 0 になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
ウィンドウ内の各カラー インデックス プレーンには、サイズが 2^n のパレットがあります。 n はレイヤー プレーン内のビットプレーンの数です。 パレットの透明なインデックスを変更することはできません。
レイヤー パレットを実現するには、 wglRealizeLayerPalette 関数を使用します。 最初は、レイヤー パレットには白のエントリのみが含まれます。
wglSetLayerPaletteEntries 関数は、メイン平面パレットのパレット エントリを設定しません。 メイン平面パレットを更新するには、GDI パレット関数を使用します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h |
| Library | Opengl32.lib |
| [DLL] | Opengl32.dll |