SetSystemPaletteUse功能允许应用程序指定系统调色板是否包含2或20个静态颜色。默认系统调色板包含20个静态颜色。(当应用程序实现逻辑调色板时,无法更改静态颜色。)
UINT SetSystemPaletteUse(
HDC 【HDC】, | //设备上下文的句柄 |
UINT 【uUsage】 | //调色板使用标志 |
); |
参数
【HDC】
标识设备上下文。此设备上下文必须引用支持调色板的设备。
【uUsage】
指定系统调色板的新用法。此参数可以是以下值之一:
值 | 含义 |
SYSPAL_NOSTATIC | 系统调色板包含两种静态颜色(黑色和白色)。 |
SYSPAL_STATIC | 系统调色板包含静态颜色,当应用程序实现其逻辑调色板时不会改变。 |
返回值
如果函数成功,则返回值是系统调色板的以前使用(可以是SYSPAL_NOSTATIC或SYSPAL_STATIC)。
如果函数失败,返回值为SYSPAL_ERROR。要获取扩展错误信息,请调用GetLastError.
备注
应用程序可以通过调用GetDeviceCaps函数并指定RASTERCAPS常数来确定设备是否支持调色板操作。
当应用程序窗口移动到前台并设置了SYSPAL_NOSTATIC值时,应用程序必须调用GetSysColor函数来保存当前的系统颜色设置。还必须调用SetSysColors以仅使用黑白设置合理的值。当应用程序返回到后台或终止时,必须恢复以前的系统颜色。
如果函数返回SYSPAL_ERROR,则指定的设备上下文无效或不支持调色板。
应用程序只有在窗口最大化并具有输入焦点时才能调用此函数。
如果一个应用程序使用【uUsage】设置为SYSPAL_NOSTATIC来调用SetSystemPaletteUse,Windows将分别在系统调色板中为纯白色和纯黑色留出两个条目。
调用此函数后,【uUsage】设置为SYSPAL_NOSTATIC,应用程序必须执行以下步骤:
1.重新审视逻辑调色板。
2.选择GetSysColor功能来保存当前的系统颜色设置。
3.将SetSysColors函数设置为使用黑色和白色将系统颜色设置为合理的值。例如,相邻或重叠的项目(如窗口框和边框)应分别设置为黑白。
4.将WM_SYSCOLORCHANGE消息发送到其他顶级窗口,以便使用新的系统颜色进行重绘。
当应用程序的窗口失去焦点或关闭时,应用程序必须执行以下步骤:
1.将SetSystemPaletteUse参数设置为SYSPAL_STATIC。
2.重新审视逻辑调色板。
3.将系统颜色恢复为之前的值。
发送WM_SYSCOLORCHANGE消息。
也可以看看
GetDeviceCaps, GetSysColor, SetSysColors, GetSystemPaletteUse