gtkmm 3.24中通过Builder XML向窗口添加按钮的问题排查

问题背景 #

使用C++和gtkmm 3.24开发GUI应用，采用myWindow.h、myWindow.cpp、main.cpp和builder.ui的分离结构，空窗口可正常创建，但添加按钮时出现两个问题：

• 调用p_builder->get_widget<Gtk::Button>("button1")编译失败，报错：no matching function for call to ‘Gtk::Builder::get_widget<Gtk::Button>(const char [8])’
• 修改为p_builder->get_widget("button1", addButton)可编译，但运行时触发Gtk::BuilderError崩溃，try/catch无法捕获详细错误，syslog显示核心转储。

错误原因分析 #

编译错误原因 #

gtkmm 3.24的Gtk::Builder::get_widget模板版本要求显式指定模板参数的同时传入指针引用，原调用缺少指针引用参数，不符合函数签名。正确的模板版本签名为：

template <class T>
bool get_widget(const Glib::ustring& name, T*& widget);

运行时崩溃原因 #

1. 异常捕获时机错误：原代码将app->run(*window)放入try块，但get_widget_derived调用时已触发MainWindow构造，此时获取按钮的代码执行抛出的异常未被捕获，直接导致崩溃。
2. UI布局非法：builder.ui中直接将GtkButton作为GtkWindow的子部件，但GtkWindow不能直接容纳按钮，必须通过GtkGrid、GtkBox等容器作为中间层，否则部件无法正确初始化，触发Builder错误。

修正方案与代码 #

步骤1：修正UI文件，添加容器 #

修改builder.ui，给窗口添加GtkGrid容器，将按钮放入容器内：

<?xml version="1.0" encoding="UTF-8"?>
<interface>
  <requires lib="gtk+" version="3.22"/>
  <object class="GtkWindow" id="mainWindow">
    <property name="title">Grid</property>
    <property name="default-width">600</property>
    <property name="default-height">400</property>
    <child>
      <object class="GtkGrid" id="mainGrid">
        <property name="margin">10</property>
        <property name="row-spacing">10</property>
        <property name="column-spacing">10</property>
        <child>
          <object class="GtkButton" id="button1">
            <property name="label">Button</property>
            <layout>
              <property name="column">1</property>
              <property name="row">1</property>
            </layout>
          </object>
        </child>
      </object>
    </child>
  </object>
</interface>

步骤2：修正MainWindow构造函数的get_widget调用 #

使用正确的模板版本调用，同时添加异常判断：

myWindow.h 新增按钮成员变量

#pragma once
#include <gtkmm/window.h>
#include <gtkmm/builder.h>
#include <gtkmm/grid.h>
#include <gtkmm/button.h>

class MainWindow : public Gtk::Window
{
public:
  MainWindow(BaseObjectType* cobject, const Glib::RefPtr<Gtk::Builder>& p_builder);
protected:
  Glib::RefPtr<Gtk::Builder> m_builder;
  Gtk::Button* m_button1; // 新增按钮成员
};

myWindow.cpp 修正get_widget调用

#include "myWindow.h"
#include <stdexcept>

MainWindow::MainWindow(BaseObjectType* cobject, const Glib::RefPtr<Gtk::Builder>& p_builder)
: Gtk::Window(cobject), m_builder(p_builder)
{
    // 模板版本调用：传入指针引用
    if (!p_builder->get_widget<Gtk::Button>("button1", m_button1))
    {
        throw std::runtime_error("Failed to get widget 'button1'");
    }

    // 非模板版本调用方式（可选）：
    // p_builder->get_widget("button1", m_button1);
    // if (!m_button1)
    // {
    //     throw std::runtime_error("Failed to get widget 'button1'");
    // }
}

步骤3：修正main.cpp的异常捕获位置 #

将get_widget_derived调用移至try块内，确保构造窗口时的异常能被捕获：

#include <iostream>
#include <gtkmm/application.h>
#include <gtkmm/builder.h>
#include "myWindow.h"

int main(int argc, char** argv)
{
    auto app = Gtk::Application::create(argc, argv);
    auto builder = Gtk::Builder::create_from_file("builder.ui");
    MainWindow* window = nullptr;

    try
    {
        builder->get_widget_derived("mainWindow", window);
        if (!window)
        {
            throw std::runtime_error("Failed to create MainWindow");
        }
        app->run(*window);
    }
    catch(const Gtk::BuilderError& bdre)
    {
        std::cerr << "Builder error: " << bdre.what() << std::endl;
    }
    catch(const std::runtime_error& re)
    {
        std::cerr << "Runtime error: " << re.what() << std::endl;
    }
    catch(const std::exception& ex)
    {
        std::cerr << "Error occurred: " << ex.what() << std::endl;
    }
    catch(...)
    {
        std::cerr << "Unknown failure occurred. Possible memory corruption" << std::endl;
    }

    delete window; // 手动释放窗口内存
    return 0;
}

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