接口

GtkFileChooser

已过时：4.10 

说明 [src]

interface Gtk.FileChooser : GObject.Object

GtkFileChooser 是一个接口，可由文件选择小组件实现。

在 GTK 中，实现此接口的主要对象是 GtkFileChooserWidget 和 GtkFileChooserDialog。

除非你尝试调整现有的文件选择器以公开标准编程接口，否则无需编写实现 GtkFileChooser 接口的对象。

GtkFileChooser 允许对文件系统中的多个位置使用快捷方式。在默认实现中，这些快捷方式显示在左窗格中。令人有些困惑的是，这些快捷方式首先来自各种来源，其次有不同的形式，在此解释一下术语 此处

  • 书签：由用户创建，方法是从右窗格将文件夹拖放到左窗格，或使用“添加”。用户可以重命名和删除书签。

  • 快捷方式：可由应用程序提供。例如，绘图程序可能希望添加剪贴画文件夹的快捷方式。用户无法修改快捷方式。

  • 卷：由底层文件系统抽象提供。它们是文件系统的“根”。

文件名称和编码

当用户在 GtkFileChooser 中完成文件选择时，你的程序可以将选定的文件名作为 GFile 获取。

添加选项

可通过使用 gtk_file_chooser_add_choice() 向文件选择器中添加额外的微件，为未在默认设计中提供的选项提供服务。每个选项配有一个标识符和用户可见的标签；此外，每个选项都可有多个选项。如果一个选项没有选项，它将作为带有给定标签的复选框呈现；如果一个选项有选项，它将作为组合框呈现。

已弃用：4.10 起

改用 GtkFileDialog 。

先决条件

为了实现 FileChooser，您的类型必须从 GObject 继承。

实现

实例方法

gtk_file_chooser_add_choice

向文件选择器中添加一个“选项”。

已过时：4.10 

gtk_file_chooser_add_filter

添加 filter 到用户可以选择之间的过滤器列表中。

已过时：4.10 

gtk_file_chooser_add_shortcut_folder

添加一个文件夹，在文件选择器中显示在快捷方式文件夹中。

已过时：4.10 

gtk_file_chooser_get_action

获取文件选择器执行的操作类型。

已过时：4.10 

gtk_file_chooser_get_choice

获取给定 ID“选项”中当前所选的选项。

已过时：4.10 

gtk_file_chooser_get_create_folders

获取文件选择器是否会建议创建新文件夹。

已过时：4.10 

gtk_file_chooser_get_current_folder

获取当前 chooser 文件夹的 GFile。

已过时：4.10 

gtk_file_chooser_get_current_name

获取文件选择器中的当前名称，由用户输入。

已过时：4.10 

gtk_file_chooser_get_file

获取文件选择器中当前所选文件的 GFile。

已过时：4.10 

gtk_file_chooser_get_files

列出 chooser 当前文件夹中的所有选定文件和子文件夹，作为 GFile。

已过时：4.10 

gtk_file_chooser_get_filter

获取当前过滤器。

已过时：4.10 

gtk_file_chooser_get_filters

获取当前一组用户可选择的过滤器，作为列表模型。

已过时：4.10 

gtk_file_chooser_get_select_multiple

获取是否可以在文件选择器中选择多个文件。

已过时：4.10 

gtk_file_chooser_get_shortcut_folders

查询文件选择器中的快捷方式文件夹列表。

已过时：4.10 

gtk_file_chooser_remove_choice

移除通过 gtk_file_chooser_add_choice() 添加的“选项”。

已过时：4.10 

gtk_file_chooser_remove_filter

从用户可以选择之间的过滤器列表中移除 filter。

已过时：4.10 

gtk_file_chooser_remove_shortcut_folder

从文件选择器中的快捷方式文件夹中移除一个文件夹。

已过时：4.10 

gtk_file_chooser_set_action

设置选择器执行的操作类型。

已过时：4.10 

gtk_file_chooser_set_choice

选择通过 gtk_file_chooser_add_choice() 添加的“选项”中的一个选项。

已过时：4.10 

gtk_file_chooser_set_create_folders

设置文件选择器是否会建议创建新文件夹。

已过时：4.10 

gtk_file_chooser_set_current_folder

从 GFile 设置 chooser 的当前文件夹。

已过时：4.10 

gtk_file_chooser_set_current_name

设置文件选择器中的当前名称，仿佛是用户输入的。

已过时：4.10 

gtk_file_chooser_set_file

设置 file 作为文件选择器的当前文件名。

已过时：4.10 

gtk_file_chooser_set_filter

设置当前过滤器。

已过时：4.10 

gtk_file_chooser_set_select_multiple

设置是否可以在文件选择器中选择多个文件。

已过时：4.10 

属性

Gtk.FileChooser:action

文件选择器执行的操作类型。

已过时：4.10 

Gtk.FileChooser:create-folders

是否在不是 GTK_FILE_CHOOSER_ACTION_OPEN 模式的文件选择器中建议用户创建新文件夹。

已过时：4.10 

Gtk.FileChooser:filter

用于选择所显示文件的当前过滤器。

已过时：4.10 

Gtk.FileChooser:filters

包含通过 gtk_file_chooser_add_filter() 添加的过滤器的 GListModel。

已过时：4.10 

Gtk.FileChooser:select-multiple

是否允许选择多个文件。

已过时：4.10 

Gtk.FileChooser:shortcut-folders

包含使用 gtk_file_chooser_add_shortcut_folder() 添加的快捷方式文件夹的 GListModel。

已过时：4.10