SetSystemPaletteUse

【勇芳软件工作室】汉化HomePreviousNext

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