getSysColorBrush 函数 (winuser.h)

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

语法

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

参数

[in] nIndex

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

返回值

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

注解

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

应用程序不得使用系统画笔为窗口注册窗口类。 若要使用系统颜色注册窗口类,请参阅 WNDCLASSWNDCLASSEX 结构的 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 (

另请参阅

画笔函数

画笔概述

CreateSolidBrush

GetSysColor

SetSysColors

WNDCLASS

WNDCLASSEX