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

另请参阅

颜色函数

颜色概述

GetDeviceCaps

SetSystemPaletteUse