8.1信息对话框

在这一小节中,我们来看看以下四种用来提供信息的对话框:wxMessageDialog, wxProgressDialog, wxBusyInfo, and wxShowTip.

wxMessageDialog

这种对话框显示一个消息和一组按钮,按钮可以为OK, Cancel, Yes或者No,还可以有一个可选的图标,用来显示一个惊叹号或者一个问号.消息文本中还可以包含换行符"\n".

wxMessageDialog::ShowModal函数的返回值用来表征哪个按钮被按下了.

下图显示了wxMessageDialog在windows平台上的样子:

在GTK+平台上:

在Mac平台上:

要创建一个这种对话框,你需要提供父窗口指针,要显示的消息,可选的标题,类型和位置参数,然后调用ShowModal函数显示这个对话框,然后判断这个函数的返回值进行进一步的动作.

其中的类型参数是一个比特位列表,其值如下表所示:

wxMessageDialog使用举例

#include "wx/msgdlg.h"
wxMessageDialog dialog( NULL, wxT("Message box caption"),
      wxT("Message box text"),
      wxNO_DEFAULT|wxYES_NO|wxCANCEL|wxICON_INFORMATION);
switch ( dialog.ShowModal() )
{
  case wxID_YES:
      wxLogStatus(wxT("You pressed \"Yes\""));
      break;
  case wxID_NO:
      wxLogStatus(wxT("You pressed \"No\""));
      break;
  case wxID_CANCEL:
      wxLogStatus(wxT("You pressed \"Cancel\""));
      break;
  default:
      wxLogError(wxT("Unexpected wxMessageDialog return code!"));
}

wxMessageBox

你可以使用更方便的wxMessageBox函数,它的参数为一个消息文本,标题文本,类型和父窗口.例如:

if (wxYES == wxMessageBox(wxT("Message box text"),
    wxT("Message box caption"),
    wxNO_DEFAULT|wxYES_NO|wxCANCEL|wxICON_INFORMATION,
    parent))
{
    return true;
}

要注意wxMessageBox的返回值和wxMessageDialog::ShowModal的返回值是不一样的,前者返回wxOK, wxCANCEL, wxYES或wxNO,而后者返回wxID_OK, wxID_CANCEL, wxID_YES或 wxID_NO.

wxProgressDialog

wxProgressDialog可以用来显示一个短的消息文本和一个进度条用来指示用户还需要等待多久.它还可以显示一个Cancel 按钮用来中止正在进行的处理,还可以显示已经过去的时间,估计剩余的时间和估计全部的时间.这个对话框是wxWidgets在各个平台上自己实现的.下图显示了这个对话框在windows上的样子:

你既可以用全局变量或者new函数来创建这种对话框,也可以直接使用局部变量创建这种对话框,需要传递的参数包括:标题,消息文本,进度条的最大值,父窗口和类型.

类型的值如下表所示:

在进度对话框被创建以后,其父窗口将被禁用,如果设置了wxPD_APP_MODAL类型,则应用程序中其它的窗口也将被禁用.应用程序应用调用Update函数来更新进度条以及提示信息,如果设置了时间显示标签,则它们的值将被自动计算并在每次调用Update的时候刷新.

如果设置了wxPD_AUTO_HIDE类型,对话框会在进度达到最大值的时候自动隐藏,你应该自己根据其创建方式释放这个对话框.对于由于用户点击取消按钮而导致Update失败的情况,如果你愿意,你可以使用Resume函数还恢复中止的进度条.

wxProgressDialog使用举例

#include "wx/progdlg.h"
void MyFrame::ShowProgress()
{
    static const int max = 10;
    wxProgressDialog dialog(wxT("Progress dialog example"),
                              wxT("An informative message"),
                              max,    // range
                              this,   // parent
                              wxPD_CAN_ABORT |
                              wxPD_APP_MODAL |
                              wxPD_ELAPSED_TIME |
                              wxPD_ESTIMATED_TIME |
                              wxPD_REMAINING_TIME);
    bool cont = true;
    for ( int i = 0; i <= max; i++ )
    {
        wxSleep(1);
        if ( i == max )
            cont = dialog.Update(i, wxT("That's all, folks!"));
        else if ( i == max / 2 )
            cont = dialog.Update(i, wxT("Only a half left (very long message)!"));
        else
            cont = dialog.Update(i);

        if ( !cont )
        {
            if ( wxMessageBox(wxT("Do you really want to cancel?"),
                               wxT("Progress dialog question"),
                               wxYES_NO | wxICON_QUESTION) == wxYES )
                break;

            dialog.Resume();
        }
    }
    if ( !cont )
        wxLogStatus(wxT("Progress dialog aborted!"));
    else
        wxLogStatus(wxT("Countdown from %d finished"), max);
}

wxBusyInfo

wxBusyInfo其实不是一个对话框不过它的表现和对话框非常相似,当这个对象被创建的时候,屏幕上将显示一个窗口以及一条让用户耐心等待的消息,这个窗口将存在于wxBusyInfo的整个生命周期.在windows平台上,它的长相类似下面的样子:

wxBusyInfo也可以以全局和局部的方式创建,需要传递给构造函数的参数包括一个消息文本和一个父窗口.

wxBusyInfo使用举例

在下面的例子中,首先使用wxWindowDisabler对象禁用应用程序当前创建的所有的窗口,然后显示了一个wxBusyInfo窗口:

#include "wx/busyinfo.h"
wxWindowDisabler disableAll;
wxBusyInfo info(wxT("Counting, please wait..."), parent);
for (int i = 0; i < 1000; i++)
{
    DoCalculation();
}

wxShowTip

许多应用程序都会在程序启动的时候显示一个附加的窗口,用来给出一些如何使用这个应用程序的提示信息,那些不愿阅读沉闷的文档的人会非常喜欢这样的学习方式的.

启动提示窗口在windows平台上的样子如下图所示:

和大多数对话框不同,这个对话框是使用wxShowTip函数显示的,传递的参数为一个父窗口指针,一个指向wxTipProvider 对象的指针和一个可选的bool参数用来指示是否显示一个复选框,以便用户可以选择是否在应用程序启动的时候显示这个提示框.而函数的返回值则为用户的选择.

你必须实现一个wxTipProvider的派生类,实现其中的GetTip函数才可以使用wxShowTip函数,幸运的是, wxWidgets已经实现了一个这样的基于文本文件的类.你可以直接使用wxCreateFileTipProvider函数,传递以文本文件(每行一个提示文本)路径和默认选择索引来创建一个这样的类.

应用程序应负责在wxTipProvider对象不需要的时候释放这个对象.

wxShowTip使用举例

#include "wx/tipdlg.h"
void MyFrame::ShowTip()
{
    static size_t s_index = (size_t)-1;
    if ( s_index == (size_t)-1 )
    {
        // 随机化...
        srand(time(NULL));
        // ...选择一个提示
        s_index = rand() % 5;
    }
    // 传递一个提示文件以及提示索引
    wxTipProvider *tipProvider =
        wxCreateFileTipProvider(wxT("tips.txt"), s_index);
    m_showAtStartup = wxShowTip(this, tipProvider, true);
    delete tipProvider;
}