<Return[G]><Top>

GetSystemPaletteUse

Declare Function Api_GetSystemPaletteUse& Lib "gdi32" Alias "GetSystemPaletteUse" (ByVal hDC&)

Declare Function GetSystemPaletteUse Lib "gdi32" Alias "GetSystemPaletteUse" (ByVal hdc As Long) As Long

指定されたデバイスコンテキストに関連付けられている、システム(物理)パレットの現在の状態を取得する。

パラメータ
hdc
    デバイスコンテキストのハンドルを指定する。

戻り値
    関数が成功すると、システムパレットの現在の状態が返る。次の値のいずれかである。

    値                                

意味                                                                                                         

    SYSPAL_NOSTATIC

システムパレットが保持しているのは黒と白だけで、それ以外の静的な色は含まれていない。

    SYSPAL_STATIC

 

システムパレットは、アプリケーションが自らの論理パレットを実体化したときにも変更されない静的な色を保持している。

    SYSPAL_ERROR

指定されたデバイスコンテキストが無効である。または、カラーパレットをサポートしていない。

    Windows NT/2000:拡張エラー情報を取得するには、 関数を使う。

解説
    既定では、システムパレットは 20 個の静的な色を保持している。アプリケーションが RealizePalette 関数を使って論理パレットを実体化して

    も、これらの色は変化しない。アプリケーションは SetSystemPaletteUse 関数を呼び出すと、これらの色のほとんどを変更できる。
    hdc パラメータで指定したデバイスコンテキストは、カラーパレットをサポートするデバイスを表していなければならない。
    デバイスがパレット操作をサポートしているかどうかを調べるには、 GetDeviceCaps 関数で値 RASTERCAPS を指定する。