WxWidgets+CodeBlocks中用线程解决UI冻结问题

核心逻辑 #

wxWidgets的UI操作必须在主线程执行，耗时的循环任务要丢到后台线程，线程通过自定义事件通知主线程更新文本框，这样就不会阻塞UI循环导致程序无响应。

一步步改代码 #

1. 定义自定义事件 #

在你的窗口头文件（比如MyFrame.h）里添加以下代码：

// 声明自定义事件类型
wxDECLARE_EVENT(EVENT_UPDATE_TEXT, wxCommandEvent);

class MyFrame : public wxFrame
{
    // 保留wxSmith生成的原有代码，比如控件声明
    wxTextCtrl* m_textCtrl; // 你的文本控件，wxSmith生成的名字可能是textCtrl1，自行对应修改
    wxThread* m_workerThread; // 存储后台线程的指针

private:
    // 处理线程发来的文本更新请求
    void OnUpdateText(wxCommandEvent& event);
    // 原按钮点击事件函数
    void OnButtonClick(wxCommandEvent& event);
    // 窗口关闭时清理线程资源
    void OnClose(wxCloseEvent& event);

    DECLARE_EVENT_TABLE()
};

// 在cpp文件（MyFrame.cpp）中注册事件
wxDEFINE_EVENT(EVENT_UPDATE_TEXT, wxCommandEvent);

2. 实现后台线程类 #

在MyFrame.cpp中定义负责执行循环任务的线程类：

class WorkerThread : public wxThread
{
public:
    WorkerThread(MyFrame* parent) : wxThread(wxTHREAD_JOINABLE), m_parent(parent) {}

protected:
    ExitCode Entry() override
    {
        // 替换成你的循环逻辑，这里示例写入10000行文本
        for (int i = 0; i < 10000; ++i)
        {
            // 检查线程是否需要终止（比如用户关闭窗口）
            if (TestDestroy())
                break;

            // 拼接要写入的文本内容
            wxString line = wxString::Format("第%d条内容\n", i + 1);

            // 发送自定义事件给主线程，委托它更新UI
            wxCommandEvent event(EVENT_UPDATE_TEXT);
            event.SetString(line);
            wxPostEvent(m_parent, event);

            // 可选：添加1毫秒延迟，避免消息队列过载导致UI卡顿
            wxMilliSleep(1);
        }
        return nullptr;
    }

private:
    MyFrame* m_parent;
};

3. 修改按钮点击逻辑与事件绑定 #

在MyFrame.cpp的事件表中添加绑定，并修改按钮点击的实现：

BEGIN_EVENT_TABLE(MyFrame, wxFrame)
    // 保留原有事件绑定，比如按钮点击事件
    EVT_BUTTON(ID_BUTTON1, MyFrame::OnButtonClick) // 替换成你的按钮ID（wxSmith生成）
    EVT_COMMAND(wxID_ANY, EVENT_UPDATE_TEXT, MyFrame::OnUpdateText) // 绑定自定义更新事件
    EVT_CLOSE(MyFrame::OnClose) // 绑定窗口关闭事件
END_EVENT_TABLE()

void MyFrame::OnButtonClick(wxCommandEvent& event)
{
    // 防止重复点击按钮启动多个线程
    if (m_workerThread && m_workerThread->IsRunning())
        return;

    // 创建并启动后台线程
    m_workerThread = new WorkerThread(this);
    if (m_workerThread->Run() != wxTHREAD_NO_ERROR)
    {
        wxMessageBox("线程启动失败！");
        delete m_workerThread;
        m_workerThread = nullptr;
    }
}

void MyFrame::OnUpdateText(wxCommandEvent& event)
{
    // 在UI线程安全更新文本框
    m_textCtrl->AppendText(event.GetString());
}

4. 窗口关闭时清理线程资源 #

必须添加这一步，避免线程未结束就关闭程序导致内存泄漏或崩溃：

void MyFrame::OnClose(wxCloseEvent& event)
{
    if (m_workerThread && m_workerThread->IsRunning())
    {
        // 请求线程终止
        m_workerThread->Delete();
        // 等待线程执行完毕
        m_workerThread->Wait();
        delete m_workerThread;
        m_workerThread = nullptr;
    }
    event.Skip(); // 继续执行默认的窗口关闭逻辑
}

关键注意事项 #

• 绝对不能在后台线程直接调用m_textCtrl->AppendText()，必须通过wxPostEvent委托主线程处理UI更新，否则会引发崩溃或异常。
• 使用wxTHREAD_JOINABLE类型线程，方便在窗口关闭时等待线程结束，避免资源泄漏。
• 循环中的TestDestroy()必须保留，确保线程能及时响应终止请求。
• wxMilliSleep(1)可根据实际需求调整，写入内容较多时添加延迟能让UI更流畅，内容较少可直接移除。

内容的提问来源于stack exchange，提问作者anonymous