GetSystemPaletteUse 関数 (wingdi.h)

GetSystemPaletteUse 関数は、指定されたデバイスコンテキスト (DC) のシステム (物理) パレットの現在の状態を取得します。

構文

UINT GetSystemPaletteUse(
  [in] HDC hdc
);

[in] hdc

デバイスコンテキストへのハンドル。

関数が成功した場合、戻り値はシステムパレットの現在の状態になります。このパラメーターには、次の値のいずれかを指定できます。

値	意味
SYSPAL_NOSTATIC	システムパレットには、白黒以外の静的な色は含まれています。
SYSPAL_STATIC	システムパレットには、アプリケーションが論理パレットを実現したときに変更されない静的な色が含まれています。
SYSPAL_ERROR	指定されたデバイスコンテキストが無効であるか、カラーパレットをサポートしていません。

既定では、システムパレットには、アプリケーションが論理パレットを実現するときに変更されない 20 個の静的な色が含まれています。アプリケーションは、 SetSystemPaletteUse 関数を呼び出すことによって、これらの色のほとんどにアクセスできます。

hdc パラメーターで識別されるデバイスコンテキストは、カラーパレットをサポートするデバイスを表す必要があります。

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

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