GetSysColorBrush

小甲鱼

注：本文档由 haoyycom 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

GetSysColorBrush 函数用于获取一个句柄，用于确认一个与指定的颜色索引相对应的逻辑画刷。


API 函数原型：

注释：_In_ 说明该参数是输入的。

HBRUSH GetSysColorBrush(
  _In_ int nIndex
);

参数解析：

参数	含义
nIndex	颜色的索引。该值对应给一个窗口元素上色的颜色。参考 GetSysColor 函数中的系统颜色的索引值

返回值：

如果当前平台支持 nIndex 参数，返回值可以确定一个逻辑画刷。否则返回 NULL。


备注：

1. 画刷是系统用于给填充图内部上色的一个位图。一个应用程序通过调用 GetSysColor 函数来获取当前系统色。一个应用程序可以通过调用 SetSysColors 函数来设置当前系统的颜色。

2. 一个应用程序一定不能为了窗口可以使用系统笔刷而去注册一个窗口类。使用一个系统颜色注册一个窗口类，参考 WNDCLASS 结构或 WNDCLASSEX 结构的 hbrBackground 成员部分。

3. 系统颜色画刷将随系统颜色的改变而改变。换句话说，当使用者改变一个系统颜色时，关联的系统颜色画刷将自动变成那个改变后的新颜色。

4. 用系统颜色画刷绘图时，应用程序应该使用 GetSysColorBrush(nlndex)，而不是 CreateSolidBrush ( GetSysColor (nIndex))。这是因为 GetSysColorBrush 函数返回一个缓存中的笔刷，而不是分配一个新的。

5. 系统拥有系统颜色画刷，所以你没必要清空它们。尽管你不必删除 GetSysColorBrush 函数返回的逻辑刷，调用 DeleteObject 函数不会产生任何风险。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Library	User32.lib
DLL	User32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。