多屏场景下Gtkmm窗口在指定屏幕居中显示的实现方案

问题核心原因说明 #

之前的实现出现异常的核心原因：

1. 没有在窗口渲染前设置初始位置，导致首次渲染用默认位置，之后才跳转
2. 未做防循环判断，移动窗口操作会再次触发size_allocate信号，形成反复调整的死循环，表现为窗口晃动

正确实现方案 #

1. 预先获取目标屏幕参数（避免硬编码坐标失效） #

不要写死2160这类固定坐标，通过Gdk原生接口读取屏幕参数，适配多屏布局变更的场景：

#include <gtkmm.h>

// 3号屏对应索引为2（Gdk监视器索引从0开始计数）
const int TARGET_MONITOR_INDEX = 2;

Glib::RefPtr<Gdk::Monitor> get_target_monitor(const Glib::RefPtr<Gdk::Display>& display) {
    if (display->get_n_monitors() <= TARGET_MONITOR_INDEX) {
        // 索引越界时降级到主屏幕，避免崩溃
        return display->get_primary_monitor();
    }
    return display->get_monitor(TARGET_MONITOR_INDEX);
}

2. 重写realize生命周期方法设置初始位置 #

在窗口的on_realize钩子中计算初始位置，此时窗口还未渲染到屏幕，不会出现首次跳转问题：

void BaseWindow::on_realize() {
    // 先执行父类原生realize逻辑
    Gtk::Window::on_realize();

    auto display = get_display();
    auto monitor = get_target_monitor(display);
    Gdk::Rectangle monitor_geo;
    monitor->get_geometry(monitor_geo);

    // 设置窗口重力为中心，move操作的坐标直接对应窗口中心位置，无需手动计算半宽半高
    set_gravity(Gdk::GRAVITY_CENTER);
    move(monitor_geo.get_x() + monitor_geo.get_width() / 2,
         monitor_geo.get_y() + monitor_geo.get_height() / 2);
}

3. 动态尺寸变化时的居中防抖动处理 #

监听size_allocate信号时增加锁和偏差判断，避免循环触发调整：

// 类头文件中新增成员变量，用于防循环
bool m_is_updating_position = false;

void BaseWindow::on_size_allocate(Gtk::Allocation& allocation) {
    Gtk::Window::on_size_allocate(allocation);

    // 正在调整位置时直接返回，避免循环触发
    if (m_is_updating_position) {
        return;
    }
    m_is_updating_position = true;

    auto display = get_display();
    auto monitor = get_target_monitor(display);
    Gdk::Rectangle monitor_geo;
    monitor->get_geometry(monitor_geo);

    int current_x, current_y;
    get_position(current_x, current_y);
    int window_w = allocation.get_width();
    int window_h = allocation.get_height();

    // 计算目标居中位置
    int target_x = monitor_geo.get_x() + (monitor_geo.get_width() - window_w) / 2;
    int target_y = monitor_geo.get_y() + (monitor_geo.get_height() - window_h) / 2;

    // 只有位置偏差超过1px时才移动，避免不必要的重绘抖动
    if (abs(current_x - target_x) > 1 || abs(current_y - target_y) > 1) {
        move(target_x, target_y);
    }

    m_is_updating_position = false;
}

可选优化 #

如果窗口支持用户手动拖拽调整位置，可以额外加一个m_user_dragged标志位，仅在未被用户手动移动时保持自动居中，避免覆盖用户操作。

内容的提问来源于stack exchange，提问作者the.cicada.himself