类

GtkFileFilter

说明 [src]

final class Gtk.FileFilter : Gtk.Filter
  implements Gtk.Buildable {
  /* No available fields */
}

按名称或 MIME 类型过滤文件。

GtkFileFilter 可用于限制文件选择器中显示的文件。可以基于名称（使用 gtk_file_filter_add_pattern() 或 gtk_file_filter_add_suffix()）或基于 MIME 类型（使用 gtk_file_filter_add_mime_type()）过滤文件。

按 MIME 类型过滤时可以处理别名和 MIME 类型的子类；例如，对 text/plain 的过滤器也匹配 MIME 类型为 application/rtf 的文件，因为 application/rtf 是 text/plain 的子类。请注意，GtkFileFilter 允许对 MIME 类型的子类型使用通配符，例如，您可以过滤 image/*。

通常，通过将文件过滤器添加到文件选择器（参见 gtk_file_dialog_set_filters()）来使用，但也可以在任何包含 GFileInfo 对象的 GtkFilterListModel 上手动使用文件过滤器。

GtkFileFilter 作为 GtkBuildable

GtkFileFilter 对 GtkBuildable 接口的实现支持使用 <mime-types> 以及 <patterns> 和 <suffixes> 元素添加规则，并列出内部的规则。指定 <mime-type> 或 <pattern> 或 <suffix> 的效果等同于调用 gtk_file_filter_add_mime_type() 或 gtk_file_filter_add_pattern() 或 gtk_file_filter_add_suffix()。

指定 GtkFileFilter 规则的 UI 定义片段示例

<object class="GtkFileFilter">
  <property name="name" translatable="yes">Text and Images</property>
  <mime-types>
    <mime-type>text/plain</mime-type>
    <mime-type>image/ *</mime-type>
  </mime-types>
  <patterns>
    <pattern>*.txt</pattern>
  </patterns>
  <suffixes>
    <suffix>png</suffix>
  </suffixes>
</object>