1、CStatusBar在MFC中类继承关系:
CObject
CCmdTarget
CWnd
CControlBar
CStatusBar
2、CStatusBar成员函数介绍:
virtual BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_BOTTOM,
UINT nID = AFX_IDW_STATUS_BAR
);
函数用途:创建一个CStatusBar并将其与CStatusBar对象关联;
参数说明:pParentWnd:指向CStatusBar的父窗口(Windows窗口);
dwStyle:CStatusBar的类型,CBRS_TOP:将Bar放在框架的顶部,CBRS_BOTTOM:将其放在框架的底部。CBRS_NOALIGN:当父窗口改变时,不重型调整Bar;
nID:toolbar的子窗口ID;
返回值:成功返回非零,否则返回零;
2、BOOL SetIndicators(
const UINT* lpIDArray,
int nIDCount
);
函数用途:加载lpIDArray中的ID所对应的字符串资源,并将ID所对应的文本保存在字符串资源中;
参数说明:lpIDArray:ID队列指针
nIDCount:队列中元素的个数;
返回值:成功返回非零,否则返回零;
3、BOOL SetPaneText(
int nIndex,
LPCTSTR lpszNewText,
BOOL bUpdate = TRUE
);
函数用途:将CStatustBar中的长方块设置成lpszNewText所指向的内容;
参数说明:nIndex:长方块的索引号
lpszNewText:需要加载的内容;
bUpdate:等于TRUE时,当加载了新的字符内容后,将长方块设置为无效。无效使得窗口自动刷行,那么新内容就被显示在界面上了。
4、void GetItemRect(
int nIndex,
LPRECT lpRect
) const;
函数用途:将nIndex所在的位置的矩形坐标拷贝到lpRect中。
参数说明:nIndex:长方块的标识;
lpRect:指向Rect结构的指针,用来保存获得到的矩形坐标;
返回值:无
注意:坐标是以象素为单位的,原点在左上角。
5、void GetPaneInfo(
int nIndex,
UINT& nID,
UINT& nStyle,
int& cxWidth
) const;
函数用途:获得Pane的相关信息:ID,Style,宽度。
参数说明:nIndex:需要获得的Pane的索引
nID:nIndex所对应Pane的ID
nStyle:nIndex对应的Pane的类型;
cxWidth:nIndex对应的Pane的宽度;
返回值:无
6、void SetPaneInfo(
int nIndex,
UINT nID,
UINT nStyle,
int cxWidth
);
函数说明:设置Pane的相关信息;
参数说明:nIndex:需要设置的Pane的索引;
其余和5相同;
返回值:无
7、void SetPaneStyle(
int nIndex,
UINT nStyle
);
函数说明:设置Pane的类型
参数说明:nIndex:需要设置的Pane的索引
nStyle:类型;
返回值:无
8、UINT GetPaneStyle(
int nIndex
) const;
函数说明:获得Pane的类型
参数说明:nIndex:需要获得的Pane的索引
返回值:无
使用CStatusBar:
1、修改MainFrame中定义的静态变量indicators[]中成员为自己定义的ID,这里数组的下表就是函数中使用iIndex,
2、创建一个新MFC类,从CStatusBar类继承,可以在其中增加对CStatusBar的操作函数;
3、将CMainFrame中定义的CStatusBars m_wndStatusBar;改为自己增加类的对象,例如CMyStatusBar m_wndStatusBar;
例子:
1、修改indicators[]如下:
static UINT indicators[] =
{
ID_SEPARATOR, // 状态行指示器
ID_INDICATOR_CAPS,
ID_INDICATOR_NUM,
ID_INDICATOR_SCRL,
ID_SEPARATOR,
ID_SEPARATOR,
};
2、创建新类,在其中增加相应的处理函数,本例中没有增加其他的处理函数;
3、对菜单添加CMainFrame命令响应,函数如下:
void CMainFrame::OnModifybar()
{
// TODO: 在此添加命令处理程序代码
m_wndStatusBar.SetPaneText(2,"ab");
}
4、运行点击刚才添加命令响应的菜单,查看状态条的第三个Pane会显示“ab”;
void EnableDocking(DWORD dwDockStyle);
参数: dwDockStyle 指定框架窗口的哪一边可作为控件条的停靠点,可为以下之中的一个或几个:
· CBRS_ALIGN_TOP 允许停靠到用户区的顶部。
· CBRS_ALIGN_BOTTOM 允许停靠到用户区底部。
· CBRS_ALIGN_LEFT 允许停靠到用户区左边。
· CBRS_ALIGN_RIGHT 允许停靠到用户区右边。
· CBRS_ALIGN ANY 允许停靠到用户区任意一边。
说明:
调用此成员函数使框架窗口中的可停靠控件条可用。缺省时,控件条会以下面顺序停靠于框架窗口中:顶部、底部、左部、右部。