4.3 状态栏的设计与实现

优质

小牛编辑

142浏览

2023-12-01

状态栏实际上是个窗口，一般分为几个窗格，每个窗格显示不同的信息。AppWizard会为应用程序自动创建一个状态栏，该状态栏包括几个窗格，分别用来显示状态栏提示和CAPS LOCK、NUM LOCK 、SCROLL LOCK键的状态。在MFC中，状态栏的功能由CStatusBar类实现。

创建一个状态栏需要以下几个步骤：

构建一个CStatusBar对象。
调用CStatusBar::Create创建状态栏窗口。
调用CStatusBar::SetIndicators函数分配窗格，并将状态栏的每一个窗格与一个字符串ID相联系。

相应的代码读者可以在Record工程的CMainFrame::OnCreate成员函数中找到。如清单4.6所示。

清单4.6 创建状态栏

…

if (!m_wndStatusBar.Create(this) ||

!m_wndStatusBar.SetIndicators(indicators, sizeof(indicators)/sizeof(UINT)))

{

TRACE0("Failed to create status bar\n");

return -1; // fail to create

}

…

SetIndicators函数的第一个参数indicators是一个ID数组，在CMainFrame类所在的CPP文件的开头部分可以找到该数组，如清单4.7所示。

清单4.7 ID数组

static UINT indicators[] =

{

ID_SEPARATOR, // status line indicator

ID_INDICATOR_CAPS,

ID_INDICATOR_NUM,

ID_INDICATOR_SCRL,

};

indicator数组提供了状态栏窗格的分配信息，它的第一项一般为ID_SEPARATOR，该ID对应的窗格用来显示命令提示信息，后三项都是字符串ID，读者可以在String Table字符串资源中找到这三个字符串分别是CAP、NUM和SCRL。它们对应的三个窗格用来显示键盘的状态。

现在让我们来给状态栏再加一个时间窗格，它将用来显示系统时间。显示的格式是hh:mm:ss，即时:分:秒。

首先在indicators数组的ID_SEPARATOR项之后插入一个名为ID_INDICATOR_CLOCK的ID。然后找到并双击名为String Table的字符串资源，打开字符串资源编辑窗口。接着在编辑窗口内按Insert键以插入一个新的字符串，请指定字符串的ID为ID_INDICATOR_CLOCK，内容为00:00:00。状态栏将根据字符串的长度来确定相应窗格的缺省宽度，所以指定为00:00:00就为时间的显示预留了空间。

提示:上述方法不能动态改变窗格宽度，并且有时是不精确的，当系统字体改变时，这种做法可能会导致一些误差。考虑到该方法简单直观，且一般情况下问题不大，故本文用它来举例。如果读者对动态、精确地指定窗格感兴趣，请参看Visual C++ 5.0随光盘提供的一个名为NPP的MFC例子（在samples\mfc\general\npp目录下）。

时间窗格显示的时间必须每隔一秒钟更新一次。更新时间窗格的正文可调用CStatusBar:: SetPaneText函数，要定时更新，则应利用WM_TIMER消息。在Windows中用户可以安装一个或多个计时器，计时器每隔一定的时间间隔就会自动发出一个WM_TIMER消息，而这个时间间隔可由用户指定。MFC的Window类提供了WM_TIMER消息处理函数OnTimer，我们应在该函数内进行更新时间窗格的工作。

请读者利用ClassWizard给CMainFrame类加入WM_TIMER的消息处理函数OnTimer和WM_CLOSE消息的处理函数OnClose，具体方法是在Class name栏中选择CMainFrame，在Object IDs栏中选择CMainFrame，在Messages栏中找到WM_TIMER和WM_CLOSE项，分别双击之然后按OK按钮退出ClassWizard。CMainFrame::OnClose函数是在关闭主框架窗口是被调用的，程序可以在该函数中做一些清除工作。

接下来请按清单4.8修改程序。

清单4.8 CMainFrame类的部分代码

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)

{

…

SetTimer(1,1000,NULL);

return 0;

}

void CMainFrame::OnTimer(UINT nIDEvent)

{

// TODO: Add your message handler code here and/or call default

CTime time;

time=CTime::GetCurrentTime();

CString s=time.Format("%H:%M:%S");

m_wndStatusBar.SetPaneText(m_wndStatusBar.CommandToIndex(ID_INDICATOR_CLOCK),s);

CFrameWnd::OnTimer(nIDEvent);

}

void CMainFrame::OnClose()

{

// TODO: Add your message handler code here and/or call default

KillTimer(1);

CFrameWnd::OnClose();

}

在CMainFrame::OnCreate函数内调用了CWnd::SetTimer以安装一个计时器，SetTimer的第一个参数指定计时器ID为1，第二个参数则规定了计时器的时间间隔为1000毫秒即1秒。这样，每隔1秒OnTimer函数就会被调用一次。

在OnTimer函数中，首先构建了一个CTime对象，接着调用CTime的静态成员函数GetCurrentTime以获得当前的系统时间，然后利用CTime::Format函数返回一个按时:分:秒的格式表示的字符串，最后调用CStatusBar::SetPaneText来更新时间窗格显示的正文。SetPaneText的第一个参数是窗格的索引，对于某一个窗格ID，可调用CStatusBar::CommandToIndex来获得索引。

在撤销主框架窗口时应关闭计时器，因此在CMainFrame::OnClose函数内调用了KillTimer函数。

现在让我们来看一下CMainFrame的消息映射，在CMainFrame类所在CPP文件的开始部分可以找到该类的消息映射，如清单4.9所示。

清单4.9

BEGIN_MESSAGE_MAP(CMainFrame, CFrameWnd)

//{{AFX_MSG_MAP(CMainFrame)

ON_WM_CREATE()

ON_COMMAND(ID_RECORD_STOP, OnRecordStop)

ON_COMMAND(ID_RECORD_START, OnRecordStart)

ON_UPDATE_COMMAND_UI(ID_RECORD_START, OnUpdateRecordStart)

ON_UPDATE_COMMAND_UI(ID_RECORD_STOP, OnUpdateRecordStop)

ON_COMMAND(ID_HIGH_QUALITY, OnHighQuality)

ON_COMMAND(ID_LOW_QUALITY, OnLowQuality)

ON_UPDATE_COMMAND_UI(ID_HIGH_QUALITY, OnUpdateHighQuality)

ON_UPDATE_COMMAND_UI(ID_LOW_QUALITY, OnUpdateLowQuality)

ON_COMMAND(ID_VIEW_TOOLBAR1, OnViewToolbar1)

ON_UPDATE_COMMAND_UI(ID_VIEW_TOOLBAR1, OnUpdateViewToolbar1)

ON_WM_TIMER()

ON_WM_CLOSE()

//}}AFX_MSG_MAP

END_MESSAGE_MAP()

读者可以看到，在消息映射表中，ClassWizard为消息处理函数和命令处理函数自动加入了消息映射。自动加入的部分呈灰色显示，位于注释行//{{AFX_MSG_MAP和//}}AFX_MSG_MAP 之间。命令处理函数由ON_COMMAND宏来映射，命令更新处理函数由ON_UPDATE_COMMAND_UI，而WM_消息的处理函数由ON_WM_消息宏来映射。

提示:今后只要看到//{{AFX_...的注释对，则说明它们之间的部分是ClassWizard自动加入的，这部分呈灰色显示。请不要随便修改它们，更不能把手工加入的部分放在//{{AFX_...注释对内，否则有可能导致ClassWizard出错。

编译并运行Record ，可以看到状态栏的新变化，最终的界面如图4.8所示。

T4_8.tif (116548 bytes)

图4.8 最终的Record程序

小结

本章主要向读者介绍了工具条和状态栏的一些实用技术。要点如下：

在MFC中，创建一个窗口一般分两步：1.构建一个窗口对象。构建的方法是定义一个对象或用new操作符动态创建之。2.调用窗口类的Create成员函数。该函数把实际的窗口作出来，并将其HWND保存在窗口的公共数据成员m_hWnd中。
创建工具条和状态栏的工作是在CMainFrame::OnCreate函数中完成的，OnCreate函数是在创建窗口时被调用的，这时窗口的创建已部分完成，窗口对象的HWND句柄也已有效，但窗口还是不可见的。因此一般在OnCreate函数中作一些诸如创建子窗口的初始化工作。
afx_msg前缀保证了正确版本的消息处理函数被调用。
工具条有两个要素：工具条资源和工具条类CToolBar。若用户只需要一个工具条，可利用AppWizard自动生成，然后再修改之。若需要多个工具条，则必须手工创建。
如果不为命令定义命令处理函数或命令更新处理函数，则框架将自动使该命令对应的用户接口对象（主要指菜单项和按钮）禁止。利用ClassWizard可以十分方便的加入命令处理函数和命令更新处理函数。
在菜单下拉之前，或在工具条按钮处在空闲循环期间，MFC会发一个更新命令，这将导致命令更新处理函数的调用。命令更新处理函数利用CCmdUI类来更新用户接口对象。调用CCmdUI::Enable可使用户接口对象允许或禁止，调用CCmdUI::SetCheck可使用户接口对象选中或不选中。
调用CWnd::ShowWindow可以隐藏/显示一个窗口。
要在状态栏中插入新的窗格，需要在indicator数组中插入新的字符串ID。而状态栏将根据这个字符串的长度来确定新窗格的缺省宽度。
调用CStatusBar:: SetPaneText可更新状态栏窗格显示的正文。