<Return[G]><Top>

GetSystemPaletteEntries

Declare Function Api_GetSystemPaletteEntries& Lib "gdi32" Alias "GetSystemPaletteEntries" (ByVal hDC&, ByVal wStartIndex&, ByVal wNumEntries&, lpPaletteEntries As PALETTEENTRY)

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

指定されたデバイスコンテキストに関連付けられているシステムパレットから、指定された範囲のパレットエントリを取得する。

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

    の要素数は、nEntries パラメータで指定した値以上でなければならない。NULL を指定すると、関数から制御が返ったときにパレットの格

    納は行われず、関数の戻り値としてパレットエントリの総数が返る。

戻り値
    関数が成功すると、パレットから取得されたエントリの数が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000:拡張エラー情報を取得するには、 関数を使う。

解説
    デバイスがパレット操作をサポートしているかどうかを調べるには、 GetDeviceCaps 関数で値 RASTERCAPS を指定する。