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