在Linux下使用wxWidgets进行跨平台GUI开发（三）

南岩亦凛汀2025-06-19 12:00

创建wxWidgets应用程序

在本文中，我们将了解创建wxWidgets应用程序所需的基础知识。首先创建一个简单的示例程序，展示如何显示图标；接着通过另一个示例演示事件的使用方法；最后探讨wxWidgets应用程序中控件之间的通信机制。

一个简单的应用程序

首先我们创建一个非常基础的wxWidgets程序。

cpp 复制代码 
// 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下将显示

应用程序图标

在本示例中，我们为应用程序提供了一个图标。在窗口左上角显示小图标已成为标准做法，该图标是程序的图形标识。

cpp 复制代码 
// 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图像格式。

一个简单的按钮

在以下示例中，我们将在框架部件上创建一个按钮。我们将展示如何创建一个简单的事件处理器。

cpp 复制代码 
// 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 应用程序的标准退出流程之一）

组件通信

了解组件如何在应用程序中进行通信非常重要。请看以下示例。

cpp 复制代码 
// 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教程的这一部分中，我们已经创建了一些简单的程序。

相关推荐
wen__xvn26 分钟前
基础数据结构第03天：顺序表（实战篇）
数据结构·c++·算法
坏柠2 小时前
C++ 进阶：深入理解虚函数、继承与多态
java·jvm·c++
虾球xz3 小时前
CppCon 2017 学习:10 Core Guidelines You Need to Start Using Now
开发语言·c++·学习
帅_shuai_4 小时前
UE5 游戏模板 —— Puzzle 拼图游戏
c++·游戏·ue5·虚幻引擎
字节高级特工4 小时前
每日一篇博客：理解Linux动静态库
linux·运维·服务器·c语言·c++·windows·ubuntu
oioihoii4 小时前
C++11可变参数模板从入门到精通
前端·数据库·c++
多吃蔬菜！！！5 小时前
C/C++内存管理
c语言·jvm·c++
程序员如山石5 小时前
QTabWidget动态生成标签页
c++·qt
大老板a6 小时前
c++左值、右值还是不懂？进来五分钟学会
c++
热门推荐
01扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解02Coze扣子平台完整体验和实践（附国内和国际版对比）03KGG转MP3工具|非KGM文件|解密音频04AI Agent | Coze 插件使用指南：从功能解析到实操步骤05DeepSeek各版本说明与优缺点分析06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07字节跳动“扣子空间”AI智能体全解析08零代码入门 | Coze——让大模型接入自己的数据库09YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】10免费可用！最强AI数字人对口型神器：让照片开口说话唱歌，支持多人对口型+全身动作，1分钟学会！（附保姆级教程）