GetPaletteEntries

GetPaletteEntries 関数は、指定した論理パレットから指定範囲のパレットエントリを取得する。

GetPaletteEntries hpal, iStart, cEntries, pPalEntries

hpal : [intptr] 論理パレットのハンドル。
iStart : [int] 取得する論理パレットの最初のエントリ。
cEntries : [int] 取得する論理パレットのエントリ数。
pPalEntries : [var] パレットエントリを受け取る PALETTEENTRY 構造体の配列へのポインタ。配列は nEntries パラメータで指定された数以上の構造体を含んでいなければならない。

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

解説

GetPaletteEntries 関数は、指定した論理パレットから指定範囲のパレットエントリを取得する。

[戻り値]
関数が成功し論理パレットのハンドルが有効なポインタ(NULL
でない)の場合、戻り値は論理パレットから取得されたエントリ数である。関数が成功し論理パレットのハンドルが NULL
の場合、戻り値は指定パレット内のエントリ数である。失敗した場合は 0 である。

[備考]
アプリケーションは GetDeviceCaps 関数を呼び出し RASTERCAPS
定数を指定することで、デバイスがパレット操作をサポートしているかを判定できる。nEntries
パラメータがパレット内に存在するエントリ数より多くのエントリを指定した場合、PALETTEENTRY 構造体の残りのメンバは変更されない。

情報