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 ( |