GTK4辅助窗口触发GtkAlertDialog后主窗口自动最小化问题排查

问题场景 #

用C语言基于GTK4开发桌面应用，从主窗口打开add_book_window辅助窗口用于添加书籍，辅助窗口包含书名、作者、ISBN三个GtkEntry输入框。点击保存按钮时，若触发GtkAlertDialog提示必填项，关闭辅助窗口后主窗口会自动最小化；不触发弹窗则无此异常。

排查信息 #

• 问题根源锁定为save按钮触发的GtkAlertDialog，相关代码：

void show_alert(const char *message, GtkWindow *parent)
{
    GtkAlertDialog *alert = gtk_alert_dialog_new(message);    
    gtk_alert_dialog_choose(alert, parent, NULL, NULL, NULL);
}

• 用GTK_DEBUG查看窗口层级时，发现GTK将GtkAlertDialog识别为已废弃的GtkMessageDialog；调试模式下该问题不会复现。
• 环境：GTK4.14.4、GCC14.1.0、Windows11家庭版；尝试将弹窗关联主窗口、移除transient_for信号、手动配置窗口关闭均无效。

成因分析 #

1. Windows平台GTK4兼容性bug：GTK4.14.4在Windows下的GtkAlertDialog可能未完全脱离GtkMessageDialog的旧实现逻辑，导致窗口层级或焦点管理异常，弹窗关闭后系统窗口管理器错误地将主窗口最小化。
2. 异步调用未正确处理：gtk_alert_dialog_choose是异步API，当前代码直接调用且忽略回调，未正确管理弹窗的生命周期，可能引发窗口状态混乱。

解决方法 #

方法1：正确处理GtkAlertDialog的异步回调 #

修改弹窗逻辑，通过回调函数管理弹窗生命周期，并在弹窗处理完成后再操作辅助窗口，避免状态冲突：

// 弹窗回调函数
static void alert_response(GObject *source_object, GAsyncResult *res, gpointer user_data)
{
    GtkAlertDialog *alert = GTK_ALERT_DIALOG(source_object);
    // 完成弹窗异步操作
    gtk_alert_dialog_choose_finish(alert, res, NULL);
    g_object_unref(alert);

    // 可选：如果需要关闭辅助窗口，在这里执行
    GtkWindow *add_book_window = GTK_WINDOW(user_data);
    gtk_window_destroy(add_book_window);
}

void show_alert(const char *message, GtkWindow *parent, GtkWindow *add_book_window)
{
    GtkAlertDialog *alert = gtk_alert_dialog_new(message);    
    // 传入回调函数和辅助窗口作为用户数据
    gtk_alert_dialog_choose(alert, parent, NULL, alert_response, add_book_window);
}

在保存按钮处理函数中调用时，传入主窗口作为弹窗父窗口：

if (!check_lenght_save_button(title, author, isbn))
{   
    // 弹窗父窗口设为主窗口，避免辅助窗口层级问题
    show_alert("Todos os campos são obrigatórios", GTK_WINDOW(win), GTK_WINDOW(add_book_window));
    return;
}

方法2：明确设置窗口层级关系 #

打开辅助窗口时，确保其正确关联主窗口，避免焦点混乱：

// 打开add_book_window时执行
gtk_window_set_transient_for(GTK_WINDOW(add_book_window), GTK_WINDOW(main_window));
gtk_window_set_modal(GTK_WINDOW(add_book_window), TRUE);

方法3：临时替代方案（兼容Windows） #

由于Windows下GtkAlertDialog存在兼容性问题，可临时使用已废弃但更稳定的GtkMessageDialog：

void show_alert(const char *message, GtkWindow *parent)
{
    GtkWidget *dialog = gtk_message_dialog_new(parent,
                                               GTK_DIALOG_MODAL,
                                               GTK_MESSAGE_WARNING,
                                               GTK_BUTTONS_OK,
                                               "%s", message);
    gtk_dialog_run(GTK_DIALOG(dialog));
    gtk_window_destroy(GTK_WINDOW(dialog));
}

方法4：弹窗关闭后手动激活主窗口 #

在辅助窗口关闭前，手动调用gtk_window_present激活主窗口，强制获取焦点：

// 在关闭add_book_window前执行
gtk_window_present(GTK_WINDOW(main_window));
gtk_window_destroy(GTK_WINDOW(add_book_window));

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