GtkFileFilter

GtkFileFilter как GtkBuildable

Реализация GtkFileFilter интерфейса GtkBuildable поддерживает добавление правил с помощью элементов <mime-types> и <patterns> и перечисление правил внутри. Указание <mime-type> или <pattern> имеет тот же эффект, что и вызов gtk_file_filter_add_mime_type() или gtk_file_filter_add_pattern().

Пример фрагмента определения пользовательского интерфейса, определяющего правила GtkFileFilter:

gtk_file_filter_new ()

GtkFileFilter *
gtk_file_filter_new (void);

Создаёт новый объект GtkFileFilter без добавленных правил.

Такой фильтр не принимает никакие файлы, поэтому он не особенно полезен, пока вы не добавите правила с помощью gtk_file_filter_add_mime_type(), gtk_file_filter_add_pattern() или gtk_file_filter_add_pixbuf_formats().

Чтобы создать фильтр, принимающий любые файлы, используйте:

<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>
    <pattern>*.png</pattern>
  </patterns>
</object>

gtk_file_filter_set_name ()

void
gtk_file_filter_set_name (GtkFileFilter *filter,
                          const char *name);

Устанавливает удобочитаемое имя фильтра; это строка, которая будет отображаться в файловом диалоге, если есть список выбираемых фильтров.

gtk_file_filter_get_name ()

const char *
gtk_file_filter_get_name (GtkFileFilter *filter);

Возвращает удобочитаемое имя фильтра. Смотрите gtk_file_filter_set_name().

gtk_file_filter_add_mime_type ()

void
gtk_file_filter_add_mime_type (GtkFileFilter *filter,
                               const char *mime_type);

Добавляет правило, разрешающее заданный тип MIME для filter .

gtk_file_filter_add_pattern ()

void
gtk_file_filter_add_pattern (GtkFileFilter *filter,
                             const char *pattern);

Добавляет правило, разрешающее шаблон в стиле оболочки к фильтру.

gtk_file_filter_add_pixbuf_formats ()

void
gtk_file_filter_add_pixbuf_formats (GtkFileFilter *filter);

Добавляет правило, разрешающее файлы изображений в форматах, поддерживаемых GdkPixbuf.

Это эквивалентно вызову gtk_file_filter_add_mime_type() для всех поддерживаемых типов MIME.

gtk_file_filter_get_attributes ()

const char **
gtk_file_filter_get_attributes (GtkFileFilter *filter);

Получает атрибуты, которые нужно заполнить для GFileInfo, передаваемого в этот фильтр.

В приложениях обычно эта функция не используется; она предназначена главным образом для использования при реализации GtkFileChooser.

gtk_file_filter_new_from_gvariant ()

GtkFileFilter *
gtk_file_filter_new_from_gvariant (GVariant *variant);

Десериализует фильтр файлов из варианта a{sv} в формате, созданном gtk_file_filter_to_gvariant().

gtk_file_filter_to_gvariant ()

GVariant *
gtk_file_filter_to_gvariant (GtkFileFilter *filter);

Сериализует фильтр файлов в вариант a{sv}.

GtkFileFilter

typedef struct _GtkFileFilter GtkFileFilter;

Свойство “name”

  “name”                     char *

Удобочитаемое имя фильтра.

Это строка, которая будет отображаться в интерфейсе выбора файла, если есть переключаемый список фильтров.

Владелец: GtkFileFilter

Флаги: Чтение / Запись

Значение по умолчанию: NULL