如何在PyGTK3中使用FileChooserNative？是否支持Python接口？

别担心，完全可以通过Python接口使用FileChooserNative！GTK3的Python绑定确实严格对应C接口文档，只是官方针对Python的示例较少而已。我给你整理了完整的用法指南和示例代码，一步一步来：

前提条件 #

首先确保你的GTK3版本≥3.20（FileChooserNative是这个版本才引入的），可以通过以下代码检查版本：

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk
print(f"GTK版本: {Gtk.get_major_version()}.{Gtk.get_minor_version()}")

核心示例代码 #

下面是一个完整的可运行示例，实现点击按钮弹出原生文件选择器，并处理选中结果：

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk

class NativeFileChooserDemo(Gtk.Window):
    def __init__(self):
        super().__init__(title="原生文件选择器Demo")
        self.set_default_size(350, 250)

        # 创建触发按钮
        select_btn = Gtk.Button(label="选择本地文件")
        select_btn.connect("clicked", self.launch_file_chooser)
        self.add(select_btn)

    def launch_file_chooser(self, widget):
        # 初始化FileChooserNative
        file_chooser = Gtk.FileChooserNative.new(
            title="请选择要打开的文件",
            parent=self,  # 关联主窗口，确保对话框层级正确
            action=Gtk.FileChooserAction.OPEN,  # 选择动作：打开文件
            accept_label="确认打开",
            cancel_label="取消"
        )

        # 可选：添加文件类型过滤器
        text_filter = Gtk.FileFilter()
        text_filter.set_name("文本文件")
        text_filter.add_mime_type("text/plain")
        text_filter.add_pattern("*.txt")
        
        image_filter = Gtk.FileFilter()
        image_filter.set_name("图片文件")
        image_filter.add_mime_type("image/jpeg")
        image_filter.add_mime_type("image/png")
        
        file_chooser.add_filter(text_filter)
        file_chooser.add_filter(image_filter)

        # 运行对话框并处理响应
        response = file_chooser.run()
        if response == Gtk.ResponseType.ACCEPT:
            selected_path = file_chooser.get_filename()
            print(f"选中文件路径: {selected_path}")
            # 这里可以添加你的业务逻辑，比如读取文件内容
        elif response == Gtk.ResponseType.CANCEL:
            print("用户取消了选择")

        # 记得销毁对话框，避免内存泄漏
        file_chooser.destroy()

# 启动应用
if __name__ == "__main__":
    win = NativeFileChooserDemo()
    win.connect("destroy", Gtk.main_quit)
    win.show_all()
    Gtk.main()

关键API说明 #

• Gtk.FileChooserNative.new()：创建实例的核心方法，参数对应C接口的各个参数，其中：
  • parent：必须传入主窗口对象，否则对话框可能会出现层级异常
  • action：可选值有Gtk.FileChooserAction.OPEN（打开文件）、SAVE（保存文件）、SELECT_FOLDER（选择文件夹）
• get_filename()：获取选中文件的绝对路径，如果是选择文件夹场景，用get_current_folder()
• 保存文件场景的额外配置：如果用SAVE动作，可以添加file_chooser.set_do_overwrite_confirmation(True)来开启覆盖确认提示

常见误区 #

很多人误以为Python绑定不支持FileChooserNative，其实只是因为官方Python文档更新不及时，但只要你的GTK版本达标，直接调用就没问题。它的用法和FileChooserDialog几乎完全一致，只是前者调用系统原生的文件选择器，体验更贴合系统风格。

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