<Return[G]><Top>

GetPaletteEntries

Declare Function Api_GetPaletteEntries& Lib "gdi32" Alias "GetPaletteEntries" (ByVal hPalette&, ByVal wStartIndex&, ByVal wNumEntries&, lpPaletteEntries As PALETTEENTRY)

Declare Function GetPaletteEntries Lib "gdi32" Alias "GetPaletteEntries" (ByVal hPalette As Long, ByVal wStartIndex As Long, ByVal wNumEntries As Long, lpPaletteEntries As PALETTEENTRY) As Long

指定された論理パレットから、指定された範囲のパレットエントリを取得する。

パラメータ
hpal
    論理パレットのハンドルを指定する。
iStartIndex
    取得対象の最初のパレットエントリを指定する。
nEntries
    パレットエントリ内の取得対象のエントリの数を指定する。
lppe
    複数の 構造体からなる 1 つの配列へのポインタを指定する。関数から制御が返ると、この配列に、パレットのエントリが格納される。配列

    の要素数(PALETTEENTRY 構造体の数)は、nEntries パラメータで指定した値以上でなければならない。
 

戻り値
    関数が成功し、lppe パラメータが NULL ではない場合、取得されたエントリの数が返る。関数が成功し、lppe パラメータが NULL の場

    合、指定されたパレット内のエントリ数が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000:拡張エラー情報を取得するには、 関数を使う。

解説
    デバイスがパレット操作をサポートしているかどうかを調べるには、 GetDeviceCaps 関数で値 RASTERCAPS を指定する。
    hpal パラメータで指定した論理パレットに存在するエントリ数より、nEntries パラメータで指定したエントリ数が多い場合、残りの要素( 構造

    体)の内容は変更されない。