Gtkmm3 如何在不使用Gtk::Builder的ShortcutsWindow中正常显示快捷键

内容不显示的核心原因 #

窗口能正常弹出但快捷键区域空白，基本都是触发了GTK内部的硬层级校验规则导致的：

• ShortcutsWindow 不允许直接挂载ShortcutsShortcut控件，直接添加会被静默忽略
• 必须严格遵循三层嵌套结构：ShortcutsWindow 挂载 ShortcutsSection，ShortcutsSection 挂载 ShortcutsGroup，ShortcutsGroup 才能挂载 ShortcutsShortcut
• 仅对窗口本身调用show()不会触发全层级子控件的渲染逻辑，必须调用show_all()统一更新所有控件的可见性状态

完整可运行示例代码 #

#include <gtkmm.h>

int main(int argc, char* argv[]) {
  auto app = Gtk::Application::create(argc, argv, "org.example.shortcutdemo");
  
  // 初始化ShortcutsWindow，设置基础尺寸和标题
  Gtk::ShortcutsWindow shortcuts_window;
  shortcuts_window.set_default_size(420, 220);
  shortcuts_window.set_title("应用快捷键");

  // 第一层：ShortcutsSection，作为窗口的核心内容容器
  auto section = Gtk::manage(new Gtk::ShortcutsSection());
  section->set_section_name("main-section");
  section->set_title("快捷键列表");
  shortcuts_window.add(*section);

  // 第二层：ShortcutsGroup，作为同类快捷键的分组容器
  auto group = Gtk::manage(new Gtk::ShortcutsGroup());
  group->set_title("全局操作");
  section->add(*group);

  // 第三层：单个ShortcutsShortcut，设置快捷键触发键和显示文案
  auto shortcut = Gtk::manage(new Gtk::ShortcutsShortcut());
  shortcut->set_accelerator("<Ctrl>Q");
  shortcut->set_title("退出应用程序");
  group->add(*shortcut);

  // 关键：遍历所有子控件设置可见性，不能仅调用show()
  shortcuts_window.show_all();

  return app->run(shortcuts_window);
}

编译命令：
g++ shortcut_demo.cpp -o shortcut_demo pkg-config --cflags --libs gtkmm-3.0``

避坑提醒 #

• 不要尝试省略ShortcutsSection或ShortcutsGroup层级：这个规则是GTK源码里硬编码的类型检查，跳过就会出现控件被丢弃不渲染的问题，连调试报错都没有
• 不要手动释放Gtk::manage托管的子控件：托管对象会在所属父容器销毁时自动释放，手动delete会直接触发内存崩溃
• 加速键格式要匹配GTK规范：修饰键必须用尖括号包裹，比如<Ctrl>Q代表Ctrl+Q，格式写错会导致加速键图标无法正常渲染

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