Gtk3/Gtkmm在Wayland平台移动窗口的技术咨询

你遇到的这个问题其实是Wayland和X11核心架构差异导致的典型痛点——Wayland把窗口位置的控制权完全交给了compositor（窗口管理器），应用程序不能像在X11里那样直接修改顶级窗口的位置。咱们针对你的三个问题逐一解答：

1. 文档说法是否属实？ #

完全属实。这里的关键细节要拆解清楚：

• 顶级窗口：指独立的、直接由compositor管理的窗口（比如普通的应用主窗口、对话框）。Wayland的设计理念就是让compositor全权负责窗口的布局、位置和装饰，所以你调用Gtk::Window::move或Gdk::Window::move时，compositor有权忽略这个请求——这就是你操作无效的核心原因。
• 子窗口：文档里的“子窗口”指的是嵌入在父窗口内部的非顶级窗口，比如某个容器控件里的子窗口、或者通过set_parent关联到父窗口Gdk对象的窗口。这类窗口的位置由父窗口（应用程序）管理，compositor不会干预，所以move操作是可靠的。

2. 如何设置子窗口实现移动？ #

set_transient_for不是正确的方式——它只是把一个顶级窗口（比如对话框）标记为另一个顶级窗口的“临时关联窗口”（比如模态对话框），本质上还是两个独立的顶级窗口，compositor依然会管理它的位置。

要创建真正可移动的子窗口，你需要将窗口的Gdk对象设置为父窗口Gdk对象的子元素，具体实现如下：

gtkmm示例代码 #

#include <gtkmm.h>

int main(int argc, char* argv[]) {
  auto app = Gtk::Application::create(argc, argv, "org.example.embedded_child");

  Gtk::Window main_win;
  main_win.set_default_size(600, 400);
  main_win.set_title("Main Window");

  // 创建要移动的子窗口
  Gtk::Window child_win;
  child_win.set_title("Movable Child Window");
  child_win.set_default_size(200, 150);

  // 确保窗口的Gdk对象已初始化
  main_win.show();
  child_win.show();

  auto main_gdk_win = main_win.get_window();
  auto child_gdk_win = child_win.get_window();

  if (main_gdk_win && child_gdk_win) {
    // 将子窗口的Gdk对象绑定到主窗口的Gdk对象
    child_gdk_win->set_parent(main_gdk_win);
    // 现在可以自由移动这个子窗口了
    child_win.move(50, 50);
  }

  return app->run(main_win);
}

C语言Gtk示例代码 #

#include <gtk/gtk.h>

int main(int argc, char *argv[]) {
  gtk_init(&argc, &argv);

  GtkWidget *main_win = gtk_window_new(GTK_WINDOW_TOPLEVEL);
  gtk_window_set_default_size(GTK_WINDOW(main_win), 600, 400);
  gtk_window_set_title(GTK_WINDOW(main_win), "Main Window");

  GtkWidget *child_win = gtk_window_new(GTK_WINDOW_TOPLEVEL);
  gtk_window_set_title(GTK_WINDOW(child_win), "Movable Child Window");
  gtk_window_set_default_size(GTK_WINDOW(child_win), 200, 150);

  // 先显示窗口确保Gdk对象存在
  gtk_widget_show(main_win);
  gtk_widget_show(child_win);

  GdkWindow *main_gdk = gtk_widget_get_window(main_win);
  GdkWindow *child_gdk = gtk_widget_get_window(child_win);

  if (main_gdk && child_gdk) {
    gdk_window_set_parent(child_gdk, main_gdk);
    gtk_window_move(GTK_WINDOW(child_win), 50, 50);
  }

  gtk_main();
  return 0;
}

这种方式创建的子窗口会嵌入在主窗口内部，位置完全由应用控制，不会被compositor干预。

3. 是否有其他方式在Wayland上移动顶级窗口？ #

遗憾的是，Wayland的设计不允许应用程序直接强制移动顶级窗口——这是为了保证compositor的窗口管理规则一致性（比如平铺式窗口管理器不允许随意拖动窗口）。不过有几个可选方向：

• 用户交互触发拖动：可以调用Gtk::Window::begin_move_drag()（C语言是gtk_window_begin_move_drag()），模拟用户点击标题栏拖动窗口的行为。这个方法需要传入鼠标事件参数，只能在用户交互回调（比如鼠标点击事件）中调用，compositor会认可这种用户发起的移动请求。
• 依赖compositor扩展协议：部分compositor（比如KWin、 Mutter）支持自定义扩展协议，允许应用请求移动窗口，但这不是通用标准，只能在特定环境下工作，没有跨平台的解决方案。
• Subsurface的用途：Subsurface是Wayland里用来在顶级窗口中嵌入另一个绘制表面的机制，它不是用来移动顶级窗口的，而是用来实现复杂的UI嵌入（比如浏览器里的插件窗口），和你要的窗口移动需求不匹配。

另外你提到Qt5在Wayland下也有同样的问题，这完全正常——因为Qt遵循Wayland的规范，同样不能直接修改顶级窗口的位置，只有嵌入式子窗口的move操作有效。

内容的提问来源于stack exchange，提问作者aiutopia.dev