平台 SDK: Windows GDI

SetSystemPaletteUse

SetSystemPaletteUse函数允许应用程序指定系统调色板是否包含2或20个静态颜色。 默认系统调色板包含20个静态颜色。 (当应用程序实现逻辑调色板时,无法更改静态颜色。)

UINT SetSystemPaletteUse(
  HDC hdc,      // 设备上下文句柄
  UINT uUsage   // 调色板使用
);

参数

  • hdc

  • [in] 设备上下文句柄。 此设备上下文必须引用支持调色板的设备。

  • uUsage

  • [in] 指定系统调色板的新用法。 此参数可以是以下值之一。

    含义
    SYSPAL_NOSTATIC系统调色板包含两种静态颜色(黑色和白色)。
    SYSPAL_NOSTATIC256Windows 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后调用此函数后,应用程序必须执行以下步骤:

  1. 实现逻辑调色板。

  2. 调用GetSysColor函数来保存当前的系统颜色设置。

  3. 调用SetSysColors函数将系统颜色设置为合适的值,使用黑色和白色。 例如,相邻或重叠的项目(如窗口框和边框)应分别设置为黑白。

  4. 将WM_SYSCOLORCHANGE消息发送到其他顶级窗口,以便使用新的系统颜色进行重绘。

当应用程序的窗口失去焦点或关闭时,应用程序必须执行以下步骤:

  1. 调用SetSystemPaletteUse,将uUsage参数设置为SYSPAL_STATIC。

  2. 实现逻辑调色板。

  3. 将系统颜色还原到以前的值。

  4. 发送WM_SYSCOLORCHANGE消息。

要求

   Windows NT/2000/XP:包含在Windows NT 3.1及更高版本中。

   Windows 95/98/Me:包含在Windows 95及更高版本中。

   头文件:声明于Wingdi.h; 包含于Windows.h。

   库:使用Gdi32.lib。