SetPaletteEntries 関数 (wingdi.h)

[アーティクル]
03/04/2024

SetPaletteEntries 関数は、論理パレット内のエントリの範囲に RGB (赤、緑、青) の色の値とフラグを設定します。

構文

UINT SetPaletteEntries(
  [in] HPALETTE           hpal,
  [in] UINT               iStart,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *pPalEntries
);

パラメーター

[in] hpal

論理パレットへのハンドル。

[in] iStart

最初に設定する論理パレットエントリ。

[in] cEntries

設定する論理パレットエントリの数。

[in] pPalEntries

RGB 値とフラグを含む PALETTEENTRY 構造体の配列の最初のメンバーへのポインター。

戻り値

関数が成功した場合、戻り値は論理パレットで設定されたエントリの数です。

関数が失敗した場合は、0 を返します。

注釈

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

論理パレットが選択され、実現された場合でも、パレットに対する変更は、サーフェス内の物理パレットには影響しません。新しい論理パレットをサーフェスに設定するには、もう一度 RealizePalette を呼び出す必要があります。

要件

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