描述
SetSystemPaletteUse功能允许应用程序指定系统调色板是否包含2或20个静态颜色。默认系统调色板包含20个静态颜色。（当应用程序实现逻辑调色板时，无法更改静态颜色。）
C++ 语法
UINT SetSystemPaletteUse( __in HDC hdc, __in UINT uUsage ); |
PowerBASIC 语法
FUNCTION SetSystemPaletteUse ( _ BYVAL hdc AS DWORD, _ BYVAL uUsage AS DWORD _ ) AS DWORD |
参数
hdc
[in]处理设备上下文。此设备上下文必须引用支持调色板的设备。
uUsage
[in]指定系统调色板的新用法。此参数可以是以下值之一。
值 |
含义 |
SYSPAL_NOSTATIC |
系统调色板包含两种静态颜色（黑色和白色）。 |
SYSPAL_NOSTATIC256 |
Windows 2000 / XP/ VISTA / Windows 7的：系统调色板不包含静态颜色。 |
SYSPAL_STATIC |
系统调色板包含静态颜色，当应用程序实现其逻辑调色板时不会改变。 |
返回值
如果函数成功，返回值就是以前的系统调色板。它可以是SYSPAL_NOSTATIC，SYSPAL_NOSTATIC256或SYSPAL_STATIC。en
如果函数失败，返回值为SYSPAL_ERROR。
Windows NT / 2000 / XP / Vista / Windows 7：要获取扩展错误信息，请调用GetLastError.
备注
应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。
当应用程序窗口移动到前台并设置了SYSPAL_NOSTATIC值时，应用程序必须调用GetSysColor功能来保存当前的系统颜色设置。还必须调用SetSysColors才能使用黑白设置合理的值。当应用程序返回到后台或终止时，必须恢复以前的系统颜色。
如果函数返回SYSPAL_ERROR，则指定的设备上下文无效或不支持调色板。
应用程序只有在窗口最大化并具有输入焦点时才能调用此函数。
如果应用程序在uUsage设置为SYSPAL_NOSTATIC的情况下调用SetSystemPaletteUse，系统将分别在系统调色板中为纯白色和纯黑色留出两个条目。
在将uUsage设置为SYSPAL_NOSTATIC后调用此函数后，应用程序必须执行以下步骤：
1.实现逻辑调色板。
2.调用GetSysColor功能来保存当前的系统颜色设置。
3.调用SetSysColors功能，将系统颜色设置为合理的值，使用黑色和白色。例如，相邻或重叠的项目（如窗口框和边框）应分别设置为黑白。
4.将WM_SYSCOLORCHANGE消息发送到其他顶级窗口，以便使用新的系统颜色重绘。
当应用程序的窗口失去焦点或关闭时，应用程序必须执行以下步骤：
1.调用SetSystemPaletteUse，将uUsage参数设置为SYSPAL_STATIC。
2.实现逻辑调色板。
3.将系统颜色还原到以前的值。
4.发送WM_SYSCOLORCHANGE消息。
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）