49 views
| 平台 SDK: Windows GDI |
SetSystemPaletteUse
SetSystemPaletteUse函数允许应用程序指定系统调色板是否包含2或20个静态颜色。 默认系统调色板包含20个静态颜色。 （当应用程序实现逻辑调色板时，无法更改静态颜色。）
UINT SetSystemPaletteUse( HDC hdc, // 设备上下文句柄 UINT uUsage // 调色板使用 );
参数
hdc
[in] 设备上下文句柄。 此设备上下文必须引用支持调色板的设备。
uUsage
[in] 指定系统调色板的新用法。 此参数可以是以下值之一。
值 含义 SYSPAL_NOSTATIC 系统调色板包含两种静态颜色（黑色和白色）。 SYSPAL_NOSTATIC256 Windows 2000/XP: 系统调色板不包含静态颜色。 SYSPAL_STATIC 系统调色板包含静态颜色，当应用程序实现其逻辑调色板时不会改变。
返回值
如果函数成功，返回值就是以前的系统调色板。 它可以是SYSPAL_NOSTATIC，SYSPAL_NOSTATIC256或SYSPAL_STATIC。
如果函数失败，返回值为SYSPAL_ERROR。
Windows NT/2000/XP: 要获取扩展错误信息，请调用GetLastError。
备注
应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常量来确定设备是否支持调色板操作。
当应用程序窗口移动到前台并设置了SYSPAL_NOSTATIC值时，应用程序必须调用GetSysColor函数来保存当前的系统颜色设置。它也必须调用SetSysColors来设置仅使用黑色和白色的合理值。当应用程序返回到后台或终止时，必须恢复以前的系统颜色。
如果函数返回SYSPAL_ERROR，则指定的设备上下文无效或不支持调色板。
应用程序只有在窗口最大化并具有输入焦点时才能调用此函数。
如果应用程序在uUsage设置为SYSPAL_NOSTATIC的情况下调用SetSystemPaletteUse，系统将分别在系统调色板中为纯白色和纯黑色留出两个条目。
在将uUsage设置为SYSPAL_NOSTATIC后调用此函数后，应用程序必须执行以下步骤：
实现逻辑调色板。
调用GetSysColor函数来保存当前的系统颜色设置。
调用SetSysColors函数将系统颜色设置为合适的值，使用黑色和白色。 例如，相邻或重叠的项目（如窗口框和边框）应分别设置为黑白。
将WM_SYSCOLORCHANGE消息发送到其他顶级窗口，以便使用新的系统颜色进行重绘。
当应用程序的窗口失去焦点或关闭时，应用程序必须执行以下步骤：
调用SetSystemPaletteUse，将uUsage参数设置为SYSPAL_STATIC。
实现逻辑调色板。
将系统颜色还原到以前的值。
发送WM_SYSCOLORCHANGE消息。
要求
Windows NT/2000/XP：包含在Windows NT 3.1及更高版本中。
Windows 95/98/Me：包含在Windows 95及更高版本中。
头文件：声明于Wingdi.h; 包含于Windows.h。
库：使用Gdi32.lib。