勇芳软件工作室.汉化:  Brushes > Brush Functions >

GetSysColorBrush

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

HBRUSH GetSysColorBrush(

__in int nIndex

);

 

PowerBASIC 语法

 

FUNCTION GetSysColorBrush( _

BYVAL nIndex AS LONG _

) AS DWORD

 

参数

 

nIndex

 

[in]指定颜色索引。该值对应于用于绘制其中一个窗口元素的颜色。有关系统颜色索引值,请参阅GetSysColor.

 

返回值

 

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

 

备注

 

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

 

应用程序不能使用系统画笔为窗口注册窗口类。要注册具有系统颜色的窗口类,请参阅WNDCLASSWNDCLASSEX结构的hbrBackground成员的文档。

 

系统颜色刷跟踪系统颜色的变化。换句话说,当用户更改系统颜色时,相关联的系统颜色刷自动更改为新颜色。

 

要使用系统颜色画笔进行绘制,应用程序应使用GetSysColorBrush(nIndex)而不是GetSysColor({n}}(nIndex)),因为GetSysColorBrush返回一个缓存的画笔,而不是分配一个新的画笔。

 

系统颜色刷由系统拥有,不得被破坏。

 

引用文件 #INCLUDE Once

 

WinUser.h(包括windows.inc)