如何在GTK4与Rust中显示基于复合模板的模态窗口

我之前做GTK4+Rust项目时也碰到过一模一样的需求——主窗口用复合模板，还要弹出同样基于复合模板的模态窗口，其实搞清楚几个关键点就很简单了，下面一步步给你讲：

第一步：定义基于复合模板的模态对话框 #

首先得把你的对话框类用CompositeTemplate宏实现好，这里我推荐继承gtk::Dialog（它天生适合做模态交互窗口），当然如果你需要自定义窗口样式，继承gtk::Window也可以，步骤差不多。

先写结构体和子类实现：

use gtk::prelude::*;
use gtk::{CompositeTemplate, Dialog, TemplateChild};
use glib::subclass::prelude::*;

// 定义对话框结构体，绑定UI模板资源
#[derive(Default, CompositeTemplate)]
#[template_resource = "/com/yourapp/MyModalDialog.ui"]
pub struct MyModalDialog {
    // 绑定模板里的控件，比如确认按钮
    #[template_child]
    ok_btn: TemplateChild<gtk::Button>,
}

impl MyModalDialog {
    // 构造方法，传入主窗口作为父窗口
    pub fn new(parent: &gtk::Window) -> Self {
        let dialog = Self::default();
        // 关键1：设置对话框的临时父窗口，确保模态作用于主窗口
        dialog.set_transient_for(Some(parent));
        // 关键2：开启模态模式，此时主窗口会被锁定无法操作
        dialog.set_modal(true);
        // 可以在这里绑定对话框内部控件的事件，比如点击确认按钮关闭窗口
        dialog.ok_btn.connect_clicked(glib::clone!(@weak dialog => move |_| {
            dialog.close();
        }));
        dialog
    }
}

// 必须实现的子类Trait，绑定模板
#[glib::object_subclass]
impl ObjectSubclass for MyModalDialog {
    const NAME: &'static str = "MyModalDialog";
    type Type = super::MyModalDialog;
    type ParentType = Dialog;

    fn class_init(klass: &mut Self::Class) {
        klass.bind_template();
    }

    fn instance_init(obj: &InitializingObject<Self>) {
        obj.init_template();
    }
}

// 实现父类的Impl Trait
impl ObjectImpl for MyModalDialog {}
impl WidgetImpl for MyModalDialog {}
impl WindowImpl for MyModalDialog {}
impl DialogImpl for MyModalDialog {}

第二步：在主窗口中触发显示模态对话框 #

假设你的主窗口也是用复合模板写的，比如有个按钮用来触发弹窗，只需要在按钮的点击回调里实例化对话框，然后显示就行：

// 主窗口的结构体定义（省略子类实现部分，和对话框类似）
#[derive(Default, CompositeTemplate)]
#[template_resource = "/com/yourapp/MyMainWindow.ui"]
pub struct MyMainWindow {
    #[template_child]
    open_dialog_btn: TemplateChild<gtk::Button>,
}

impl MyMainWindow {
    pub fn new() -> Self {
        let window = Self::default();
        // 绑定按钮点击事件
        window.open_dialog_btn.connect_clicked(glib::clone!(@weak window => move |_| {
            // 实例化对话框，传入当前主窗口作为父窗口
            let dialog = MyModalDialog::new(&window);
            // 如果需要阻塞直到对话框关闭，用run()方法
            // dialog.run();
            // dialog.close();
            // 如果不需要阻塞，直接用present()显示
            dialog.present();
        }));
        window
    }
}

几个需要注意的点 #

• 模板资源路径要正确：确保你的.ui文件被正确打包到GResource里，路径要和代码里的#[template_resource]一致
• 模态生效的前提：必须设置transient_for，不然模态可能不会正确绑定到主窗口
• 两种显示方式：run()会阻塞当前线程直到对话框关闭，适合需要获取对话框返回结果的场景；present()是非阻塞的，适合不需要等待结果的场景

内容来源于stack exchange