如何在GIMP 3 Python插件中创建匹配其样式的打开文件对话框

问题原因 #

GIMP 3的API已移除Gimp.get_main_window()方法，旧的主窗口获取方式不再适用。要让文件选择对话框继承GIMP样式，需正确获取GIMP主窗口并将其设为对话框的父窗口。

解决方案 #

1. 获取GIMP主窗口：通过Gimp.DisplayManager获取默认显示窗口，再提取对应的GTK窗口对象
2. 关联父窗口：将GIMP主窗口作为父窗口传入文件选择对话框，使其继承GIMP的主题样式
3. 替换过时按钮常量：GTK4已废弃Gtk.STOCK_*系列常量，改用标准按钮添加方式

修改后的代码 #

def select_txt_file():
    # 获取GIMP主窗口（GIMP 3标准API）
    display_manager = Gimp.get_display_manager()
    default_display = display_manager.get_default_display()
    if not default_display:
        return None  # 处理无显示窗口的极端场景
    parent_window = default_display.get_window()

    # 创建文件选择对话框，指定父窗口为GIMP主窗口
    dialog = Gtk.FileChooserDialog(
        title="Select a text file",
        parent=parent_window,
        action=Gtk.FileChooserAction.OPEN
    )

    # 添加操作按钮（替代过时的STOCK常量）
    dialog.add_button("_Cancel", Gtk.ResponseType.CANCEL)
    dialog.add_button("_Open", Gtk.ResponseType.OK)

    # 设置.txt文件过滤规则
    filter_txt = Gtk.FileFilter()
    filter_txt.set_name("Text files")
    filter_txt.add_pattern("*.txt")
    dialog.add_filter(filter_txt)

    # 运行对话框并处理返回结果
    response = dialog.run()
    filename = dialog.get_filename() if response == Gtk.ResponseType.OK else None

    dialog.destroy()
    return filename

关键说明 #

• Gimp.get_display_manager().get_default_display().get_window()：这是GIMP 3中获取主窗口的官方方式，完全替代了旧版的get_main_window()
• 指定parent=parent_window：让对话框成为GIMP主窗口的子窗口，自动继承GIMP的界面样式，不再显示系统原生样式
• 使用add_button()：规避GTK4中STOCK_*常量的废弃警告，同时保持按钮的标准交互逻辑

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