CStatic类

CStatic类提供了一个Windows静态控件的功能。一个静态控件可以用来显示一
个文本字符串、方框、矩形、图标、光标、位图或增强的图元文件。它可以被用来作为
标签、方框或用来分隔其它的控件。静态控件通常不接收输入，也不提供输出；但是，
如果它具有SS_NOTIFY风格，则它可以通知其父有关设备点击的消息。
创建一个静态控件分两步。首先，调用构造函数来构造一个CStatic类的对象，然后调用
成员函数Create来创建此静态控件并将它分配给当前的CStatic类的对象。
如果你是在一个对话框中创建了一个静态控件(通过一个对话框资源)，则当用户关闭这
个对话框时， CStatic类的对象被自动销毁。
如果你是在一个窗口中创建了一个CStatic类的对象，则可能需要你自己来销毁它。在一
个窗口的堆栈中创建的CStatic类的对象将自动被销毁。如果你是使用new函数在堆中创
建CStatic类的对象，则当你使用完后，必须调用delete来销毁这个CStatic类的对象。

【库 名】<afxwin.h>


【成员函数】

（1）BOOL Create(LPCTSTR lpszText, DWORD dwStyle, const RECT& rect, CWnd* pP
arentWnd, UINT nID = 0xffff);
【返回值】如果本成员函数调用成功则返回非零值；否则返回0。
【参 数】
lpszText
指定要放置在静态控件中的文本。如果是NULL，则表示没有文本是可见的。
dwStyle
指定静态控件的窗口风格。以下任何静态控件风格的组合都可以用于这个控件。
SS_BITMAP
指定在静态控件中显示一个被定义在资源文件中的位图。该风格将忽略静态控件的高度
和宽度，静态控件将根据位图的大小自动调节自身的尺寸。
SS_BLACKFRAME
建立一个黑色的边框。
SS_BLACKRECT
建立一个黑色的矩形。
SS_CENTER
使文字在静态控件中水平居中。
SS_CENTERIMAGE
当静态控件用于显示文本时，该风格将使文本在静态控件中垂直居中。当静态控件用于
显示位图或图标时，该风格将使位图或图标在静态控件中垂直居中，当位图或图标小于
静态控件时，静态控件将使用位图或图标左上角的点的颜色填充空白处。
SS_ENHMETAFILE
指定在静态控件中显示一个增强型图元文件。该风格将不会忽略静态控件的高度和宽度
，而图元文件将调节自身的大小来适应静态控件的尺寸。
SS_ETCHEDFRAME
建立一个浮雕边框。
SS_ETCHEDHORZ
建立一个边框，并将顶端边框设置为浮雕风格。
SS_ETCHEDVERT
建立一个边框，并将左侧边框设置为浮雕风格。
SS_GRAYFRAME
建立一个灰色的边框。
SS_GRAYRECT
建立一个灰色的矩形。
SS_ICON
指定在静态控件中显示一个被定义在资源文件中的图标。该风格将忽略静态控件的高度
和宽度，静态控件将根据位图的大小自动调节自身的尺寸。
SS_LEFT
使文字在静态控件中左对齐。
SS_LEFTNOWORDWRAP
在缺省情况下，静态控件把’\n’和’\t’都作为换行标记。只有在设置本风格后，静
态控件才把’\t’看作是制表键(缺省时制表键的宽度为8个字符的宽度)。
SS_NOPREFIX
该标志表示终止对前缀字符的处理。通常，本成员函数将前缀助记符’&’解释为一个指
令，即在’&’后面的字符下面划一下划线。并且将’&&’解释成一个单个的’&’指令
。通过指令指定该标志，这种处理就不再进行了。
SS_NOTIFY
在缺省情况下，静态控件是不响应鼠标事件的。只有在设置该风格后，当用户单击静态
控件时，静态控件才向父窗口发送STN_CLICKED通知。
SS_OWNERDRAW
在指定该风格后，当静态控件在视觉外观发生变化时，该静态控件的属主窗口将响应WM
_DRAWITEM消息。
SS_RIGHT
使文字在静态控件中左对齐。
SS_SIMPLE
只显示一行文本，文本不能被剪切或替换(父窗口不能处理CTLCOLOR消息)。
SS_SUNKEN
设置一个下沉的静态控件，当静态控件为一个方框时，方框的四边下沉；当静态控件为
一个矩形时，整个矩形下沉。
SS_USERITEM
建立一个用户自定义项目。
SS_WHITEFRAME
建立一个白色的边框。
SS_WHITERECT
建立一个白色的矩形。
rect
指定静态控件的位置和大小。它可以是一个RECT结构类型的数据或一个CRect类的对象。

pParentWnd
指定CStatic类的对象的父窗口，通常是一个CDialog类的对象。它不能是NULL。
nID = 0xffff
指定静态控件的控件标识。
【注释】在使用静态控件显示文本而且没有设置SS_LEFTNOWORDWRAP风格时，’\n’和
’\t’都忧患行的作用。两者的区别是在一行文本的长度大于静态控件的宽度时使用’
\n’换行将使该行文本的下一行也为空行，但使用’\t’则无此现象。

（2）CStatic();
【注 释】构造一个空的CStatic类的对象。

（3）HBITMAP GetBitmap() const;
【返回值】返回一个当前位图的句柄，如果没有设置位图，则返回NULL。
【注释】此成员函数用来获取先前用成员函数SetBitmap设置的与CStatic类的对象关联
的位图句柄。

（4）HCURSOR GetCursor();
【返回值】返回一个当前图标句柄。如果没有设置图标则返回NULL。
【注释】此成员函数用来获取先前用成员函数SetCursor设置的与CStatic类的对象关联
的光标句柄。

（5）HENHMETAFILE GetEnhMetaFile() const;
【返回值】返回一个当前增强图元文件句柄。如果没有设置增强的图元文件则返回NULL
【注释】此成员函数用来获取先前用成员函数SetEnhMetaFile设置的与CStatic类的对
象关联的增强的图元文件句柄。

（6）HICON GetIcon();
【返回值】返回一个当前图标句柄。如果没有设置增强的图标则返回NULL。
【注释】此成员函数用来获取先前用成员函数SetIcon设置的与CStatic对象关联关联的
图标句柄。

（7）HBITMAP SetBitmap(HBITMAP hBitmap) const;
【返回值】返回先前与此静态控件关联的位图的句柄。如果没有与此静态控件关联的位
图，则返回NULL。
【参 数】
hBitmap
要绘制在此静态控件中的位图句柄。
【注释】此成员函数用来将一个新的位图与此静态控件关联。这个位图将被自动绘制在
此静态控件中。缺省的，它将被绘制在左上角，并且此静态控件将根据位图的大小来调
整尺寸。使用此成员函数必须设置风格SS_BITMAP。

（8）HCURSOR SetCursor(HCURSOR hCursor);
【返回值】返回先前与此静态控件关联的光标的句柄。如果没有与此静态控件关联的光
标，则返回NULL。
【参 数】
hCursor
要绘制在此静态控件中的光标句柄。
【注释】此成员函数用来将一个新的光标与此静态控件关联。这个光标将被自动绘制在
此静态控件中。缺省的，它将被绘制在左上角，并且此静态控件将根据光标的大小来调
整尺寸。使用此成员函数必须设置风格SS_ICON。

（9）HENHMETAFILE SetEnhMetaFile(HENHMETAFILE hMetaFile);
【返回值】返回先前与此静态控件关联的增强图元文件的句柄。如果没有与此静态控件
关联的增强图元文件，则返回NULL。
【参 数】
hMetaFile
要绘制在此静态控件中的增强图元文件句柄。
【注释】此成员函数用来将一个新的增强图元文件与此静态控件关联。这个增强图元文
件将被自动绘制在此静态控件中。缺省的，它将被绘制在左上角，并且此静态控件将根
据增强图元文件的大小来调整尺寸。使用此成员函数必须设置风格SS_ENHMETAFILE。

（10）HICON SetIcon(HICON hIcon);
【返回值】返回先前与此静态控件关联的图标的句柄。如果没有与此静态控件关联的图
标，则返回NULL。
【参 数】
hIcon
要绘制在此静态控件中的图标句柄。
【注释】此成员函数用来将一个新的图标与此静态控件关联。这个图标将被自动绘制在
此静态控件中。缺省的，它将被绘制在左上角，并且此静态控件将根据图标的大小来调
整尺寸。使用此成员函数必须设置风格SS_ICON。