标题：CBrush
概述
CBrush是封装了Windows图形设备接口（GDI）中画刷的MFC类，用于构造CBrush对象，然后传给需要画刷的CDC成员函数。具体画刷可以由实线、阴影线或指定模式的位图线构成。可参阅 CBitmap, CDC相关说明。
成员函数
构造函数Cbrush构造一个CBrush对象初始化函数CreateSolidBrush 用指定的颜色初始化画刷。
CreateHatchBrush 用指定的阴影线初始化画刷。
CreateBrushIndirect 用结构LOGBRUSH中指定的风格、颜色和模式初始化画刷。
CreatePatternBrush 用位图指定的模式初始化画刷。
CreateDIBPatternBrush 用独立于设备的位图（DIB）初始化画刷。
CreateSysColorBrush 创建一个使用系统缺省颜色的画刷。操作FromHandle 给出一个WindowsHBRUSH对象句柄时，返回一个指向CBrush对象的指针。属性GetLogBrush 取得一个LOGBRUSH结构
operator HBRUSH 返回CBrush对象上的Windows句柄
函数详解
CBrush:: CBrush
CBrush( );
CBrush( COLORREF crColor );
throw( CResouceException );
CBrush( int nIndex, COLORREF crColor );
throw( CResouceException );
CBrush( CBitmap* pBitmap );
throw( CResouceExecption );
参数
crColor指定画刷的前景色（RGB方式）。如果画刷是阴影线型的，则指定阴影线的颜色。
nIndex指定画刷阴影线采用的风格，取值如下：
 HS_BDIAGONAL45度的向下影线（从左到右）
 HS_CROSS水平和垂直方向以网格线作出阴影
 HS_DIAGCROSS 45度的网格线阴影
 HS_FDIAGONAL 45度的向上阴影线（从左到右）
 HS_HORIZONTAL 水平的阴影线
 HS_VERTICAL 垂直的阴影线
pBitmap指向CBitmap对象的指针，该对象指定了画刷要绘制的位图。
说明
类CBrush一共有四个覆盖的构造函数。不带参数的那个构造函数构造一个未初始化的CBrush对象，在使用该对象之前需要另外初始化。如果使用了不带参数的那个构造函数，则必须用CreateSolidBrush、CreateHatchBrush、CreateBrushIndirect、CreatePatternBrush或CreateDIBPatternBrush来初始化返回的CBrush对象。如果使用了带参数的构造函数，则不再需要初始化CBrush对象。带参数的构造函数在出错时会产生一个异常，而不带参数的构造函数总是成功返回。只带有一个参数COLORREF的构造函数用指定的颜色构造一个实线型的画刷。颜色是一个RGB值，可以用WINDOWS.H中的宏RGB构造出来。带两个参数的构造函数构造一个阴影线型的画刷，参数nIndex指定了阴影线模式的指数（index）。参数crColor指定了画刷的颜色。带有一个CBitmap型参数的构造函数构造一个模式化的画刷。参数指定一个位图。该位图应该是已经用CBitmap::CreateBitmap、CBitmap::CreateBitmapIndirect、CBitmap::LoadBitmap或CBitmap::CreateCompatiableBitmap建立或加载的位图。填充模式下的位图的最小尺寸为8像素×8像素。
请参阅 CBrush::CreateSolidBrush,
CBrush::CreateHatchBrush,
CBrush::CreateBrushIndirect,
CBrush::CreatPatternBrush,
CBrush::CreateDIBPatternBrush,
CGdiObject::CreateStockObject
CBrush::CreateBrushIndirect
BOOL CreateBrushIndirect( const LOGBRUSH* lpLogBrush ):
返回值
调用成功时返回非零值，否则为0。
参数
lpLogBrush指向LOGBRUSH结构的指针，结构中记录了画刷的相关信息。
说明
本函数用结构LOGBRUSH中指定的风格、颜色和模式初始化画刷。以后，该画刷可以被选为任何设备上下文的当前画刷。采用黑白位图（1位面、每像素1位）创建的画刷使用当前的文本颜色和背景色。位值置为0的像素点将用当前的文本颜色绘制。位值置为1的像素点将用当前的背景色绘制。
请参阅 
CBrush::CreateDIBPatternBrush,
CBrush::CreatePatternBrush,
CBrush::CreateSolidBrush,
CBrush::CreateHatchBrush,
CGdiObject::DeleteObject,
::CreateBrushIndirect
CGdiObject::CreateStockObject,
CBrush::CreateDIBPatternBrush
BOOL CreateDIBPatternBrush( HGLOBAL hPackedDIB, UINT nUsage );
BOOL CreateDIBPatternBrush( const void* lpPackedDIB, UINT nUsage );
返回值
调用成功时返回非零值，否则为0。
参数
hPackedDIB指定一个全局内存对象，其中包含了一个压缩的独立于设备的位图（DIB）
nUsage指明BITMAPINFO数据结构（压缩的DIB中的一部分）的bmiColors[]成员是否包含明确的RGB值或指向当前逻辑调色板的索引值。参数必须取以下值之一：
 DIB_PAL_COLORS颜色表由一个16位的索引数组组成。
 DIB_RGB_COLORS颜色表中包含字母式的RGB颜色值。
下面这个值只在第二个函数中有效：
DIB_PAL_INDICES未提供颜色表。位图中包含了指向画刷选中的设备上下文的逻辑调色板的索引。
lpPackedDIB指向一个包括了BITMAPINFO结构的压缩的DIB。BITMAPINFO结构后紧跟着的是定义位图像素的字节数组。
说明
本函数用DIB指定的模式初始化画刷。画刷随后就可以被任何支持光栅操作的设备上下文选中。
CreateDIBPatternBrush函数的两个版本在处理DIB时有些不同：
 在前一个函数中，取得DIB的句柄需要调用Windows函数::GlobalAlloc来分配内存，然后用DIB填充这块内存。
 在后一个函数中，不再需要调用函数::GlobalAlloc为压缩的DIB分配内存。
一个压缩的DIB由一个BITMAPINFO结构和紧跟着的一个字节数组（该数组定义了位图的像素）构成。用作填充模式的位图应该是8像素×8像素的。如果位图太大，Windows将用该位图的左上角的8行8列的像素来创建填充模式。当应用选择一个两种颜色的DIB模式到一个黑白的设备上下文中时，Windows将忽略DIB中指定的颜色，而用该设备上下文中当前文本的颜色和背景色显示模式画刷。DIB中对应于第一种颜色的像素（在DIB颜色表偏移为0处）将采用文本的颜色显示。DIB中对应于第二种颜色的像素（在DIB颜色表偏移为1处）将采用背景色显示。要了解有关使用以下的Windows函数的更详细的信息，请参阅联机文档“Win32 SDK程序员参考”。
 ::CreateDIBPatternBrush（本函数是为了兼容Windows3.0之前的应用而提供的，对于 Win32应用，请用函数::CreateDIBPatternBrushPt）
 ::CreateDIBPatternBrushPt（本函数只用于基于Win32的应用）
 ::GlobalAlloc
请参阅 
CBrush::CreatePatternBrush,
CBrush::CreateBrushIndirect,
CBrush::CreateSolidBrush,
CBrush::CreateHatchBrush,
CGdiObject::CreateStockObject,
CDC::SelectObject,
GdiObject::DeleteObject,
CDC::GetBrushOrg,
CDC::SetBrushOrg
CBrush::CreateHatchBrush
BOOL CreateHatchBrush( int nIndex, COLORREF crColor );
返回值
调用成功时返回非零值，否则为0。
参数
nIndex指定画刷的阴影线风格。可取的值如下：
 HS_BDIAGONAL 45度的向下影线（从左到右）
 HS_CROSS 水平和垂直方向以网格线作出阴影
 HS_DIAGCROSS45度的网格线阴影
 HS_FDIAGONAL45度的向上阴影线（从左到右）
 HS_HORIZONTAL 水平的阴影线l HS_VERTICAL 垂直的阴影线
crColor指定画刷的前景色（RGB形式的值），就是阴影的颜色。要了解更详细的信息，请参阅联机文档“Win32 SDK”中关于COLORREF的描述.
说明
本函数用指定的阴影模式和颜色初始化画刷。随后该画刷就可以被选为任何设备上下文的当前画刷了。
请参阅 
CBrush::CreateBrushIndirect,
CBrush::CreateDIBPatternBrush,
CBrush::CreatePatternBrush,
CBrush::CreateSolidBrush,
CGdiObject::CreateStockObject,
::CreateHatchBrush
CBrush::CreatePatternBrush
BOOL CreatePatternBrush( CBitmap* pBitmap );
返回值
调用成功时返回非零值，否则为0。
参数
pBitmap指定一个位图。说明本函数用位图指定的模式初始化画刷。此画刷随后就可用于任何支持光栅操作的设备上下文。由bBitmap指定的位图一般用以下的函数初始化：CBitmap:: CreateBitmap、CBitmap::CreateBitmapIndirect、CBitmap::LoadBitmap或Cbitmap:: CreateCompatibleBitmap。
用作填充模式的位图应该是8像素×8像素的。如果位图太大，Windows将用该位图的左上角的8行8列的像素来创建填充模式。删除模式画刷时不会影响相关的位图。这意味着可以用一个位图来创建任意个模式画刷。采用黑白位图（1位面、每像素1位）创建的画刷使用当前的文本颜色和背景色。位值置为0的像素点将用当前的文本颜色绘制，位值置为1的像素点将用当前的背景色绘制。要了解有关使用Windows函数::CreatePatternBrush的更详细信息，请参阅联机文档“Win32 SDK 程序员参考”。
请参阅 CBitmap,
CBrush::CreateBrushIndirect,
CBrush::CreateDIBPatternBrush,
CBrush::CreateHatchBrush,
CBrush::CreateSolidBrush,
CGdiObject::CreateStockObject
CBrush::CreateSolidBrush
BOOL CreateSolidBrush( COLORREF crColor );
返回值
调用成功时返回非零值，否则为0。
参数
crColor指定画刷颜色的一个COLORREF结构。该颜色指定了一个RGB颜色值，可以用头文件WINDOWS.H中的宏RGB生成。
说明
本函数用指定的颜色初始化画刷。随后该画刷就可用于任何设备上下文的当前画刷。当应用使用完CreateSolidBrush创建的画刷之后，应该从设备上下文中移出该画刷。
请参阅 
CBrush::CreateBrushIndirect,
CBrush::CreateDIBPatternBrush,
CBrush::CreateHatchBrush,
CBrush::CreatePatternBrush,
::CreateSolidBrush,
CGdiObject::DeleteObject
CBrush::CreateSysColorBrush
BOOL CreateSysColorBrush( int nIndex );
返回值
调用成功时返回非零值，否则为0。
参数
nIndex指定阴影线画刷的风格。可能的取值如下：
 HS_BDIAGONAL45度的向下影线（从左到右）
 HS_CROSS水平和垂直方向以网格线作出阴影
 HS_DIAGCROSS45度的网格线阴影
 HS_FDIAGONAL45度的向上阴影线（从左到右）l HS_HORIZONTAL水平的阴影线
 HS_VERTICAL垂直的阴影线
说明
本函数初始化画刷的颜色。随后该画刷就可用于任何设备上下文的当前画刷。当应用使用完CreateSysColorBrush创建的画刷之后，应该从设备上下文中移出该画刷。
请参阅 
CBrush::CreateBrushIndirect,
CBrush::CreateDIBPatternBrush,
CBrush::CreateHatchBrush,
CBrush::CreatePatternBrush,
CBrush::CreateSolidBrush,
::GetSysColorBrush,
::CreateSolidBrush,
CGdiObject::DeleteObject
CBrush::FromHandle
static CBrush* PASCAL FromHandle( HBRUSH hBrush );
返回值
调用成功时返回一个指向CBrush对象的指针，否则返回NULL。
参数
hBrush指向一个Windows GDI画刷的句柄。
说明
本函数返回一个指向CBrush对象的指针，所需参数为一个指向一个Windows GDI画刷的句柄。如果该CBrush对象没有应用到句柄上，则创建一个临时的CBrush对象并应用它。该临时CBrush对象保持有效，直到应用在它的事件循环中出现空闲时间，此时Windows会删除所有的临时图形对象。换句话说，临时对象仅在一个Windows消息的处理过程中有效。要了解有关使用图形对象的更详细信息，请参阅联机文档“Win32 SDK程序员参考”中的“图形对象”部分。
CBrush::GetLogBrush
int GetLogBrush( LOGBRUSH* pLogBrush );
返回值
调用成功且参数pLogBrush有效时，返回存到缓冲区中的字节数。调用成功但参数pLogBrush为NULL时，返回为了保存数据到缓冲区所需的字节数。否则，返回0。
参数
pLogBrush指向一个LOGBRUSH结构的指针，结构中包含了画刷的有关信息。
说明
本函数用于检索LOGBRUSH结构中的信息。该结构定义了画刷的风格、颜色和模式。例如，调用本函数来取得某个位图的颜色和模式。
示例
LOGBRUSH logbrush;brush
Existing.GetLogBrush( &logbrush );
CBrush brushOther ( logbrush,lbColor );
请参阅 LOGBRUSH, ::GetObject
CBrush::operator HBRUSH
operator HBRUSH( ) const;
返回值
调用成功时返回一个指向Windows GDI对象的句柄，该句柄表示一个CBrush对象。否则返回NULL。
说明
本操作符用于取得某个CBrush对象上的Windows GDI对象句柄。这是一个校验性操作符，可直接参考HBRUSH对象。要了解有关使用图形对象的更详细信息，请参阅联机文档“Win32 SDK程序员参考”中的“图形对象”部分。