wxWidgets 中的事件

定义
一个简单的事件示例
事件表
使用Connect()的示例
事件传播
取消事件
窗口标识符

原文： http://zetcode.com/gui/wxwidgets/events/

事件是每个 GUI 应用不可或缺的一部分。所有 GUI 应用都是事件驱动的。应用会对在其生命周期内生成的不同事件类型做出反应。事件主要由应用的用户生成。但是它们也可以通过其他方式生成，例如互联网连接，窗口管理器或计时器。当应用启动时，将创建一个主循环。该应用位于主循环中，并等待事件生成。当我们退出应用时，主循环退出。

定义

事件是来自底层框架（通常是 GUI 工具箱）的应用级信息。事件循环是一种程序结构，用于等待并调度器中的事件或消息。事件循环反复查找事件以对其进行处理。调度器是将事件映射到事件处理器的过程。事件处理器是对事件做出反应的方法。

事件对象是与事件关联的对象。通常是一个窗口。事件类型是已生成的唯一事件。

一个简单的事件示例

在 wxWidgets 中处理事件的传统方法是使用静态事件表。这受 Microsoft 基础类（MFC）的影响。一种更灵活，更现代的方法是使用Connect()方法。我们在整个 wxWidgets 教程中都使用它。

事件表

在下一个示例中，我们显示一个使用事件表的示例。

button.h

#include <wx/wx.h>
class MyButton : public wxFrame
{
public:
    MyButton(const wxString& title);
    void OnQuit(wxCommandEvent& event);
private:
    DECLARE_EVENT_TABLE()
};

button.cpp

#include "button.h"
MyButton::MyButton(const wxString& title)
       : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(270, 150))
{
  wxPanel *panel = new wxPanel(this, wxID_ANY);
  wxButton *button = new wxButton(panel, wxID_EXIT, 
      wxT("Quit"), wxPoint(20, 20));
  Centre();
}
void MyButton::OnQuit(wxCommandEvent& WXUNUSED(event))
{
    Close(true);
}
BEGIN_EVENT_TABLE(MyButton, wxFrame)
    EVT_BUTTON(wxID_EXIT,  MyButton::OnQuit)
END_EVENT_TABLE()

main.h

#include <wx/wx.h>
class MyApp : public wxApp
{
  public:
    virtual bool OnInit();
};

main.cpp

#include "main.h"
#include "button.h"
IMPLEMENT_APP(MyApp)
bool MyApp::OnInit()
{
    MyButton *button = new MyButton(wxT("Button"));
    button->Show(true);
    return true;
}

在我们的示例中，我们创建一个简单的按钮。通过单击按钮，我们关闭应用。

private:
    DECLARE_EVENT_TABLE()

在头文件中，我们使用DECLARE_EVENT_TABLE()宏声明一个事件表。

BEGIN_EVENT_TABLE(MyButton, wxFrame)
    EVT_BUTTON(wxID_EXIT,  MyButton::OnQuit)
END_EVENT_TABLE()

我们通过将每个事件映射到适当的成员函数来实现事件表。

使用`Connect()`的示例

我们将讨论移动事件。移动事件保存有关移动更改事件的信息。当我们将窗口移到新位置时，将生成一个移动事件。表示移动事件的类为wxMoveEvent。 wxEVT_MOVE是事件类型。

move.h

#include <wx/wx.h>
class Move : public wxFrame
{
public:
  Move(const wxString& title);
  void OnMove(wxMoveEvent & event);
  wxStaticText *st1;
  wxStaticText *st2;
};

move.cpp

#include "move.h"
Move::Move(const wxString& title)
       : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(250, 130))
{
  wxPanel *panel = new wxPanel(this, -1);
  st1 = new wxStaticText(panel, -1, wxT(""), wxPoint(10, 10));
  st2 = new wxStaticText(panel, -1, wxT(""), wxPoint(10, 30));
  Connect(wxEVT_MOVE, wxMoveEventHandler(Move::OnMove));
  Centre();
}
void Move::OnMove(wxMoveEvent& event)
{
  wxPoint size = event.GetPosition();
  st1->SetLabel(wxString::Format(wxT("x: %d"), size.x ));
  st2->SetLabel(wxString::Format(wxT("y: %d"), size.y ));
}

main.h

#include <wx/wx.h>
class MyApp : public wxApp
{
  public:
    virtual bool OnInit();
};

main.cpp

#include "main.h"
#include "move.h"
IMPLEMENT_APP(MyApp)
bool MyApp::OnInit()
{
    Move *move = new Move(wxT("Move event"));
    move->Show(true);
    return true;
}

该示例显示窗口的当前位置。

Connect(wxEVT_MOVE, wxMoveEventHandler(Move::OnMove));

在这里，我们将wxEVT_MOVE事件类型与OnMove()方法连接在一起。

wxPoint size = event.GetPosition();

OnMove()方法中的事件参数是特定于特定事件的对象。在我们的例子中，它是wxMoveEvent类的实例。该对象保存有关事件的信息。我们可以通过调用事件的GetPosition()方法找出当前位置。

wxWidgets 中的事件 - 图1

图：移动事件

事件传播

事件有两种类型：基本事件和命令事件。它们的传播方式不同。事件传播是事件从子小部件传播到父小部件和祖父小部件等的事件。基本事件不传播。命令事件确实传播。例如，wxCloseEvent是一个基本事件。此事件传播到父窗口小部件没有任何意义。

默认情况下，在事件处理器中捕获的事件停止传播。要继续传播，我们必须调用Skip()方法。

propagate.h

#include <wx/wx.h>
class Propagate : public wxFrame
{
public:
  Propagate(const wxString& title);
  void OnClick(wxCommandEvent& event);
};
class MyPanel : public wxPanel
{
public: 
  MyPanel(wxFrame *frame, int id);
  void OnClick(wxCommandEvent& event);
};
class MyButton : wxButton
{
public:
  MyButton(MyPanel *panel, int id, const wxString &label);
  void OnClick(wxCommandEvent& event);
};

propagate.cpp

#include <iostream>
#include "propagate.h"
const int ID_BUTTON = 1;
Propagate::Propagate(const wxString& title)
    : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(250, 130))
{
  MyPanel *panel = new MyPanel(this, -1);
  new MyButton(panel, ID_BUTTON, wxT("Ok"));
  Connect(ID_BUTTON, wxEVT_COMMAND_BUTTON_CLICKED, 
      wxCommandEventHandler(Propagate::OnClick));
  Centre();
}
void Propagate::OnClick(wxCommandEvent& event) 
{
  std::cout << "event reached frame class" << std::endl;
  event.Skip();
}
MyPanel::MyPanel(wxFrame *frame, int id)
    : wxPanel(frame, id)
{
  Connect(ID_BUTTON, wxEVT_COMMAND_BUTTON_CLICKED, 
      wxCommandEventHandler(MyPanel::OnClick));
} 
void MyPanel::OnClick(wxCommandEvent& event) 
{
  std::cout << "event reached panel class" << std::endl;
  event.Skip();
}
MyButton::MyButton(MyPanel *mypanel, int id, const wxString& label)
    : wxButton(mypanel, id, label, wxPoint(15, 15))
{
  Connect(ID_BUTTON, wxEVT_COMMAND_BUTTON_CLICKED, 
      wxCommandEventHandler(MyButton::OnClick));
} 
void MyButton::OnClick(wxCommandEvent& event) 
{
  std::cout << "event reached button class" << std::endl;
  event.Skip();
}

main.h

#include <wx/wx.h>
class MyApp : public wxApp
{
  public:
    virtual bool OnInit();
};

main.cpp

#include "main.h"
#include "propagate.h"
IMPLEMENT_APP(MyApp)
bool MyApp::OnInit()
{
    Propagate *prop = new Propagate(wxT("Propagate"));
    prop->Show(true);
    return true;
}

在我们的示例中，面板上有一个按钮。面板放置在框架小部件中。我们为所有小部件定义一个处理器。

event reached button class
event reached panel class
event reached frame class

当我们点击按钮时，我们得到了这个。事件从按钮传播到面板和框架。

尝试省略一些Skip()方法，看看会发生什么。

取消事件

有时我们需要停止处理事件。为此，我们称方法Veto()。

veto.h

#include <wx/wx.h>
class Veto : public wxFrame
{
public:
  Veto(const wxString& title);
  void OnClose(wxCloseEvent& event);
};

veto.cpp

#include "veto.h"
Veto::Veto(const wxString& title)
    : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(250, 130))
{
  Connect(wxEVT_CLOSE_WINDOW, wxCloseEventHandler(Veto::OnClose));
  Centre();
}
void Veto::OnClose(wxCloseEvent& event) 
{
  wxMessageDialog *dial = new wxMessageDialog(NULL,
      wxT("Are you sure to quit?"), wxT("Question"),
      wxYES_NO | wxNO_DEFAULT | wxICON_QUESTION);
  int ret = dial->ShowModal();
  dial->Destroy();
  if (ret == wxID_YES) {
      Destroy();
  } else {
      event.Veto();
  }
}

main.h

#include <wx/wx.h>
class MyApp : public wxApp
{
  public:
    virtual bool OnInit();
};

main.cpp

#include "main.h"
#include "veto.h"
IMPLEMENT_APP(MyApp)
bool MyApp::OnInit()
{
    Veto *veto = new Veto(wxT("Veto"));
    veto->Show(true);
    return true;
}

在我们的示例中，我们处理wxCloseEvent。当我们单击标题栏上的 X 按钮，按 Alt + F4 或从系统菜单中选择关闭时，将称为此事件。在许多应用中，如果要进行一些更改，我们希望防止意外关闭窗口。为此，我们必须连接wxEVT_CLOSE_WINDOW事件类型。

wxMessageDialog *dial = new wxMessageDialog(NULL, 
   wxT("Are you sure to quit?"), wxT("Question"),
   wxYES_NO | wxNO_DEFAULT | wxICON_QUESTION);

在关闭事件期间，我们显示一个消息对话框。

if (ret == wxID_YES) {
    Destroy();
} else {
    event.Veto();
}

根据返回值，我们销毁窗口或否决事件。注意，要关闭窗口，我们必须调用Destroy()方法。通过调用Close()方法，我们将陷入无尽的循环。

窗口标识符

窗口标识符是在事件系统中唯一确定窗口标识的整数。有三种创建窗口 ID 的方法：

让系统自动创建一个 ID。
使用标准标识符。
创建我们自己的 ID。

每个小部件都有一个 id 参数。这是事件系统中的唯一编号。如果我们使用多个小部件，则必须在它们之间进行区分。

wxButton(parent, -1)
wxButton(parent, wxID_ANY)

如果为 ID 参数提供 -1 或wxID_ANY，则让 wxWidgets 自动为我们创建一个 ID。自动创建的 ID 始终为负，而用户指定的 ID 必须始终为正。当我们不需要更改窗口小部件状态时，通常使用此选项。例如，静态文本在应用的生命周期内将永远不会更改。如果需要，我们仍然可以获取 ID。有一种方法GetId()，它将为我们确定 ID。

应尽可能使用标准标识符。标识符可以在某些平台上提供一些标准的图形或行为。

ident.h

#include <wx/wx.h>
class Ident : public wxFrame
{
public:
  Ident(const wxString& title);
};

ident.cpp

#include "ident.h"
Ident::Ident(const wxString& title)
    : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(200, 150))
{
  wxPanel *panel = new wxPanel(this, -1);
  wxGridSizer *grid = new wxGridSizer(2, 3);
  grid->Add(new wxButton(panel, wxID_CANCEL), 0, wxTOP | wxLEFT, 9);
  grid->Add(new wxButton(panel, wxID_DELETE), 0, wxTOP, 9);
  grid->Add(new wxButton(panel, wxID_SAVE), 0, wxLEFT, 9);
  grid->Add(new wxButton(panel, wxID_EXIT));
  grid->Add(new wxButton(panel, wxID_STOP), 0, wxLEFT, 9);
  grid->Add(new wxButton(panel, wxID_NEW));
  panel->SetSizer(grid);
  Centre();
}

main.h

#include <wx/wx.h>
class MyApp : public wxApp
{
  public:
    virtual bool OnInit();
};

main.cpp

#include "main.h"
#include "ident.h"
IMPLEMENT_APP(MyApp)
bool MyApp::OnInit()
{
    Ident *ident = new Ident(wxT("Identifiers"));
    ident->Show(true);
    return true;
}

在我们的示例中，我们在按钮上使用标准标识符。在 Linux 上，按钮带有小图标。

wxWidgets 中的事件 - 图2

图：标识符

在本章中，我们讨论了 wxWidgets 中的事件。

定义

一个简单的事件示例

事件表

使用Connect()的示例

事件传播

取消事件

窗口标识符

使用`Connect()`的示例