创建wxWidgets应用程序
在本文中,我们将了解创建wxWidgets应用程序所需的基础知识。首先创建一个简单的示例程序,展示如何显示图标;接着通过另一个示例演示事件的使用方法;最后探讨wxWidgets应用程序中控件之间的通信机制。
一个简单的应用程序
首先我们创建一个非常基础的wxWidgets程序。
// simple.h #include <wx/wx.h> class Simple : public wxFrame { public: Simple(const wxString& title); }; // simple.cpp #include "simple.h" Simple::Simple(const wxString& title) : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(250, 150)) { Centre(); } // main.h #include <wx/wx.h> class MyApp : public wxApp { public: virtual bool OnInit(); }; // main.cpp #include "main.h" #include "simple.h" IMPLEMENT_APP(MyApp) bool MyApp::OnInit() { Simple *simple = new Simple(wxT("Simple")); simple->Show(true); return true; }
用CMake构建工具,须编写CMakeLists.txt
cmake_minimum_required(VERSION 3.10) project(simple) if(WIN32) find_package(wxWidgets 3.2 REQUIRED COMPONENTS core base CONFIG) else() find_package(wxWidgets 3.2 REQUIRED COMPONENTS core base) endif() if(wxWidgets_USE_FILE) # not defined in CONFIG mode include(${wxWidgets_USE_FILE}) endif() set(SRC_FILES main.cpp simple.cpp ) # Define the build target for the executable, e.g. windows application. add_executable(${PROJECT_NAME} WIN32 MACOSX_BUNDLE ${SRC_FILES}) target_link_libraries(${PROJECT_NAME} ${wxWidgets_LIBRARIES}) if(MSVC) target_include_directories(${PROJECT_NAME} PUBLIC "${wxWidgets_INCLUDE_DIRS}/msvc") endif() if(CMAKE_SIZEOF_VOID_P EQUAL 8) message(STATUS "Configuring for 64-bit build.") set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/out) if(NOT MSVC) set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/out/${CMAKE_BUILD_TYPE}) endif() else() message(STATUS "Configuring for 32-bit build.") set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/out/b32) if(NOT MSVC) set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/out/b32/${CMAKE_BUILD_TYPE}) endif() endif()
现在,生成的可执行程序将会放在out文件夹内部。值得一提的是CMake采用Config模式在Windows下构建wxWidgets应用程序更好用,而在Linux下这个模式反而更麻烦了。
这个非常基础的示例在屏幕上显示了一个小窗口。该窗口位于屏幕中央。
Centre(); //这个方法将窗口在屏幕上水平和垂直居中。
IMPLEMENT_APP(MyApp) //实现应用程序的代码被隐藏在这个宏后面。
这段代码通常是复制粘贴复用的,我们一般不需要关心它。
运行效果例如在Linux下将显示

应用程序图标
在本示例中,我们为应用程序提供了一个图标。在窗口左上角显示小图标已成为标准做法,该图标是程序的图形标识。
// icon.h #include <wx/wx.h> class Icon : public wxFrame { public: Icon(const wxString& title); }; // icon.cpp #include "icon.h" Icon::Icon(const wxString& title) : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(250, 150)) { SetIcon(wxIcon(wxT("web.xpm"))); Centre(); } // main.h #include <wx/wx.h> class MyApp : public wxApp { public: virtual bool OnInit(); }; // main.cpp #include "main.h" #include "icon.h" IMPLEMENT_APP(MyApp) bool MyApp::OnInit() { Icon *icon = new Icon(wxT("Icon")); icon->Show(true); return true; }
在我们的示例中,我们展示了一个小小的网页图标。
SetIcon(wxIcon(wxT("web.xpm")));
只需一行代码即可显示应用程序图标。XPM(X PixMap)是一种ASCII图像格式。
一个简单的按钮
在以下示例中,我们将在框架部件上创建一个按钮。我们将展示如何创建一个简单的事件处理器。
// button.h #include <wx/wx.h> class Button : public wxFrame { public: Button(const wxString& title); void OnQuit(wxCommandEvent & event); }; // button.cpp #include "button.h" Button::Button(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)); Connect(wxID_EXIT, wxEVT_COMMAND_BUTTON_CLICKED, wxCommandEventHandler(Button::OnQuit)); button->SetFocus(); Centre(); } void Button::OnQuit(wxCommandEvent & WXUNUSED(event)) { Close(true); } // 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() { Button *btnapp = new Button(wxT("Button")); btnapp->Show(true); return true; }
首先我们创建一个 wxPanel 部件,它将被放置在 wxFrame 部件内部。
我们创建一个 wxButton 部件,将其放置在面板上。我们为按钮使用了预定义的 wxID_EXIT ID,这会使按钮上显示一个小的退出图标。按钮的标签是"退出"(Quit)。按钮被手动定位在坐标 x=20,y=20 处。坐标系的起点位于左上角。
当我们点击按钮时,会生成一个 wxEVT_COMMAND_BUTTON_CLICKED 事件。我们将该事件连接到 Button 类的 OnQuit 方法。因此当我们点击按钮时,就会调用 OnQuit 方法。
我们将键盘焦点设置在该按钮上。这样当我们按下回车键时,就会触发按钮的点击事件。
在 OnQuit 方法内部,我们调用了 Close 方法。这将终止我们的应用程序。
(补充说明:在 wxWidgets 框架中,调用 Close() 方法会触发 wxEVT_CLOSE_WINDOW 事件,该事件的默认处理程序会调用 wxWindow::Destroy() 来销毁窗口。对于应用程序的主窗口来说,这会进一步导致整个应用程序退出,前提是没有其他顶级窗口存在。这是 wxWidgets 应用程序的标准退出流程之一)
组件通信
了解组件如何在应用程序中进行通信非常重要。请看以下示例。
// Panels.h #include <wx/wx.h> #include <wx/panel.h> class LeftPanel : public wxPanel { public: LeftPanel(wxPanel *parent); void OnPlus(wxCommandEvent & event); void OnMinus(wxCommandEvent & event); wxButton *m_plus; wxButton *m_minus; wxPanel *m_parent; int count; }; class RightPanel : public wxPanel { public: RightPanel(wxPanel *parent); void OnSetText(wxCommandEvent & event); wxStaticText *m_text; }; const int ID_PLUS = 101; const int ID_MINUS = 102; // Panels.cpp #include <wx/stattext.h> #include "Communicate.h" LeftPanel::LeftPanel(wxPanel * parent) : wxPanel(parent, -1, wxPoint(-1, -1), wxSize(-1, -1), wxBORDER_SUNKEN) { count = 0; m_parent = parent; m_plus = new wxButton(this, ID_PLUS, wxT("+"), wxPoint(10, 10)); m_minus = new wxButton(this, ID_MINUS, wxT("-"), wxPoint(10, 60)); Connect(ID_PLUS, wxEVT_COMMAND_BUTTON_CLICKED, wxCommandEventHandler(LeftPanel::OnPlus)); Connect(ID_MINUS, wxEVT_COMMAND_BUTTON_CLICKED, wxCommandEventHandler(LeftPanel::OnMinus)); } void LeftPanel::OnPlus(wxCommandEvent & WXUNUSED(event)) { count++; Communicate *comm = (Communicate *) m_parent->GetParent(); comm->m_rp->m_text->SetLabel(wxString::Format(wxT("%d"), count)); } void LeftPanel::OnMinus(wxCommandEvent & WXUNUSED(event)) { count--; Communicate *comm = (Communicate *) m_parent->GetParent(); comm->m_rp->m_text->SetLabel(wxString::Format(wxT("%d"), count)); } RightPanel::RightPanel(wxPanel * parent) : wxPanel(parent, wxID_ANY, wxDefaultPosition, wxSize(270, 150), wxBORDER_SUNKEN) { m_text = new wxStaticText(this, -1, wxT("0"), wxPoint(40, 60)); } // Communicate.h #include "Panels.h" #include <wx/wxprec.h> class Communicate : public wxFrame { public: Communicate(const wxString& title); LeftPanel *m_lp; RightPanel *m_rp; wxPanel *m_parent; }; // Communicate.cpp #include "Communicate.h" Communicate::Communicate(const wxString& title) : wxFrame(NULL, wxID_ANY, title, wxDefaultPosition, wxSize(290, 150)) { m_parent = new wxPanel(this, wxID_ANY); wxBoxSizer *hbox = new wxBoxSizer(wxHORIZONTAL); m_lp = new LeftPanel(m_parent); m_rp = new RightPanel(m_parent); hbox->Add(m_lp, 1, wxEXPAND | wxALL, 5); hbox->Add(m_rp, 1, wxEXPAND | wxALL, 5); m_parent->SetSizer(hbox); this->Centre(); } // main.h #include <wx/wx.h> class MyApp : public wxApp { public: virtual bool OnInit(); }; // main.cpp #include "main.h" #include "Communicate.h" IMPLEMENT_APP(MyApp) bool MyApp::OnInit() { Communicate *communicate = new Communicate(wxT("Widgets communicate")); communicate->Show(true); return true; }
在我们的示例中,我们有两个面板:左侧面板和右侧面板。左侧面板有两个按钮,右侧面板有一个静态文本控件。这些按钮可以改变静态文本中显示的数字。现在的问题是:我们如何获取指向该静态文本控件的指针?
我们保存了指向 LeftPanel 父部件的指针,该父部件是一个 wxPanel 组件。
Communicate *comm = (Communicate *) m_parent->GetParent();
comm->m_rp->m_text->SetLabel(wxString::Format(wxT("%d"), count));
这两行代码是本示例中最关键的部分,它们展示了如何访问位于另一个面板上的静态文本控件。首先我们获取左右两个面板的父部件,这个父部件持有指向右侧面板的指针,而右侧面板又保存着指向静态文本控件的指针。在wxWidgets框架中,这种通过父窗口访问同级控件的模式是跨面板通信的典型实现方式。
至此,在wxWidgets教程的这一部分中,我们已经创建了一些简单的程序。