getSysColorBrush 函数 (winuser.h)

GetSysColorBrush 函数检索标识与指定颜色索引对应的逻辑画笔的句柄。

语法

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

[in] nIndex

颜色索引。此值对应于用于绘制窗口元素之一的颜色。有关系统颜色索引值，请参阅 GetSysColor 。

如果当前平台支持 nIndex 参数，则返回值标识逻辑画笔。否则，它将返回 NULL。

画笔是系统用于绘制填充形状内部的位图。应用程序可以通过调用 GetSysColor 函数来检索当前系统颜色。应用程序可以通过调用 SetSysColors 函数来设置当前系统颜色。

应用程序不得使用系统画笔为窗口注册窗口类。若要使用系统颜色注册窗口类，请参阅 WNDCLASS 或 WNDCLASSEX 结构的 hbrBackground 成员的文档。

系统颜色画笔跟踪系统颜色的更改。换句话说，当用户更改系统颜色时，关联的系统颜色画笔会自动更改为新颜色。

若要使用系统颜色画笔进行绘制，应用程序应使用 GetSysColorBrush (nIndex) 而不是 CreateSolidBrush ( GetSysColor (nIndex) ) ，因为 GetSysColorBrush 返回缓存的画笔而不是分配新的画笔。

系统颜色画笔归系统所有，因此无需销毁它们。虽然无需删除 GetSysColorBrush 返回的逻辑画笔，但调用 DeleteObject 不会造成损害。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	在 Windows 8.1) 中引入的 ext-ms-win-ntuser-gui-l1-1-1 (