GtkRecentFilter

GtkRecentFilterFunc ()

gboolean
(*GtkRecentFilterFunc) (const GtkRecentFilterInfo *filter_info,
                        gpointer user_data);

Тип функции, используемой с пользовательскими фильтрами, см. gtk_recent_filter_add_custom().

gtk_recent_filter_new ()

GtkRecentFilter *
gtk_recent_filter_new (void);

Создаёт новый GtkRecentFilter без добавления правил. Такой фильтр не принимает недавно использованные ресурсы, поэтому не очень полезен, пока вы не добавите правила с помощью gtk_recent_filter_add_pattern(), gtk_recent_filter_add_mime_type(), gtk_recent_filter_add_application(), gtk_recent_filter_add_age(). Для создания фильтра, принимающего все недавно использованные ресурсы, используйте:

<object class="GtkRecentFilter">
  <mime-types>
    <mime-type>text/plain</mime-type>
    <mime-type>image/png</mime-type>
  </mime-types>
  <patterns>
    <pattern>*.txt</pattern>
    <pattern>*.png</pattern>
  </patterns>
  <applications>
    <application>gimp</application>
    <application>gedit</application>
    <application>glade</application>
  </applications>
</object>

С: 2.10

gtk_recent_filter_get_name ()

const gchar *
gtk_recent_filter_get_name (GtkRecentFilter *filter);

Получает удобочитаемое имя фильтра. См. gtk_recent_filter_set_name().

С: 2.10

gtk_recent_filter_set_name ()

void
gtk_recent_filter_set_name (GtkRecentFilter *filter,
                            const gchar *name);

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

С: 2.10

gtk_recent_filter_add_mime_type ()

void
gtk_recent_filter_add_mime_type (GtkRecentFilter *filter,
                                 const gchar *mime_type);

Добавляет правило, позволяющее ресурсам на основе их зарегистрированного MIME-типа.

С: 2.10

gtk_recent_filter_add_pattern ()

void
gtk_recent_filter_add_pattern (GtkRecentFilter *filter,
                               const gchar *pattern);

Добавляет правило, разрешающее ресурсы на основе соответствия шаблону их имени отображения.

С: 2.10

gtk_recent_filter_add_pixbuf_formats ()

void
gtk_recent_filter_add_pixbuf_formats (GtkRecentFilter *filter);

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

С: 2.10

gtk_recent_filter_add_application ()

void
gtk_recent_filter_add_application (GtkRecentFilter *filter,
                                   const gchar *application);

Добавляет правило, позволяющее ресурсы на основе имени приложения, которое их зарегистрировало.

С: 2.10

gtk_recent_filter_add_group ()

void
gtk_recent_filter_add_group (GtkRecentFilter *filter,
                             const gchar *group);

Добавляет правило, разрешающее ресурсы на основе имени группы, к которой они относятся.

С: 2.10

gtk_recent_filter_add_age ()

void
gtk_recent_filter_add_age (GtkRecentFilter *filter,
                           gint days);

Добавляет правило, позволяющее ресурсы на основе их возраста — количество дней, прошедших с момента последнего изменения.

С: 2.10

gtk_recent_filter_add_custom ()

void
gtk_recent_filter_add_custom (GtkRecentFilter *filter,
                              GtkRecentFilterFlags needed,
                              GtkRecentFilterFunc func,
                              gpointer data,
                              GDestroyNotify data_destroy);

Добавляет правило фильтру, позволяющее ресурсы на основе пользовательской функции обратного вызова. Битовое поле needed, переданное в нём, предоставляет информацию о том, какие типы информации функция фильтра нуждается; это позволяет GTK+ избежать получения дорогостоящей информации, когда она не требуется фильтром.

С: 2.10

gtk_recent_filter_get_needed ()

GtkRecentFilterFlags
gtk_recent_filter_get_needed (GtkRecentFilter *filter);

Получает поля, которые необходимо заполнить для GtkRecentFilterInfo, передаваемого в gtk_recent_filter_filter().

Как правило, эта функция не используется приложениями; она предназначена в основном для использования при реализации GtkRecentChooser.

Since: 2.10

gtk_recent_filter_filter ()

gboolean
gtk_recent_filter_filter (GtkRecentFilter *filter,
                          const GtkRecentFilterInfo *filter_info);

Проверяет, следует ли отображать файл в соответствии с filter. GtkRecentFilterInfo filter_info должен содержать поля, возвращенные функцией gtk_recent_filter_get_needed(), и должен установить поле GtkRecentFilterInfo.contains в filter_info, чтобы указать, какие поля установлены.

Как правило, эта функция не используется приложениями; она предназначена в основном для использования при реализации GtkRecentChooser.

Since: 2.10