краткое описание

#include <gtk/gtk.h>


            gtkrecentfilter;
            gtkrecentfilterinfo;
enum        gtkrecentfilterflags;
gboolean    (*gtkrecentfilterfunc)          (const gtkrecentfilterinfo *filter_info,
                                             gpointer user_data);

gtkrecentfilter* gtk_recent_filter_new      (void);
const gchar* gtk_recent_filter_get_name     (gtkrecentfilter *filter);
void        gtk_recent_filter_set_name      (gtkrecentfilter *filter,
                                             const gchar *name);
void        gtk_recent_filter_add_mime_type (gtkrecentfilter *filter,
                                             const gchar *mime_type);
void        gtk_recent_filter_add_pattern   (gtkrecentfilter *filter,
                                             const gchar *pattern);
void        gtk_recent_filter_add_pixbuf_formats

                                            (gtkrecentfilter *filter);
void        gtk_recent_filter_add_application
                                            (gtkrecentfilter *filter,
                                             const gchar *application);
void        gtk_recent_filter_add_group     (gtkrecentfilter *filter,
                                             const gchar *group);
void        gtk_recent_filter_add_age       (gtkrecentfilter *filter,
                                             gint days);
void        gtk_recent_filter_add_custom    (gtkrecentfilter *filter,
                                             gtkrecentfilterflags needed,
                                             gtkrecentfilterfunc func,
                                             gpointer data,
                                             gdestroynotify data_destroy);

gtkrecentfilterflags gtk_recent_filter_get_needed
                                            (gtkrecentfilter *filter);
gboolean    gtk_recent_filter_filter        (gtkrecentfilter *filter,
                                             const gtkrecentfilterinfo *filter_info);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkrecentfilter

описание

gtkrecentfilter может использоваться для ограничения отображаемых в gtkrecentchooser фалов. файлы могут фильтроваться по имени (с помощью gtk_recent_filter_add_pattern()), по mime типу (с помощью gtk_file_filter_add_mime_type()), по приложениям зарегистрированным вместе с ними (с помощью gtk_recent_filter_add_application()), или выборочно (с помощью gtk_recent_filter_add_custom()).

фильтрация по mime типу обрабатывает псевдонимы и подклассы mime типов; например фильтр text/plain означает также файлы с mime типом application/rtf, так как application/rtf это подкласс text/plain. помните, gtkrecentfilter допускает шаблоны для подтипов mime типов, таким образом вы можете использовать фильтр image/*.

обычно, фильтры используются добавляя их в gtkrecentchooser, смотрите gtk_recent_chooser_add_filter(), но они также позволяют фильтровать файлы вручную gtk_recent_filter_filter().

недавно использованные файлы поддерживаются с версии gtk+ 2.10.

детали

gtkrecentfilter

typedef struct _gtkrecentfilter gtkrecentfilter;

структура gtkrecentfilter содержит только закрытые поля к которым нет непосредственного доступа.

gtkrecentfilterinfo

typedef struct {
  gtkrecentfilterflags contains;

  const gchar *uri;
  const gchar *display_name;
  const gchar *mime_type;
  const gchar **applications;
  const gchar **groups;
  
  gint age;
} gtkrecentfilterinfo;

структура gtkrecentfilterinfo используется для размещения информации о проверяемом файле в gtk_recent_filter_filter().

enum gtkrecentfilterflags

typedef enum {
  gtk_recent_filter_uri          = 1 << 0,
  gtk_recent_filter_display_name = 1 << 1,
  gtk_recent_filter_mime_type    = 1 << 2,
  gtk_recent_filter_application  = 1 << 3,
  gtk_recent_filter_group        = 1 << 4,
  gtk_recent_filter_age          = 1 << 5
} gtkrecentfilterflags;

эти флаги указывают какая часть структуры gtkrecentfilterinfo заполнена или должна быть заполнена.

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(). для создания фильтра показывающего все недавно использованные файлы используйте:

gtkrecentfilter *filter = gtk_recent_filter_new ();
gtk_recent_filter_add_pattern (filter, "*");

начиная с версии 2.10

gtk_recent_filter_get_name ()

const gchar* gtk_recent_filter_get_name     (gtkrecentfilter *filter);

выдаёт читабельное (human-readable) имя для фильтра. смотрите gtk_recent_filter_set_name().

начиная с версии 2.10

gtk_recent_filter_set_name ()

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

устанавливает читабельное (human-readable) имя фильтра; это строка которая отображается в селекторе недавно использованных файлов пользовательского интерфейса если есть список выбираемых фильтров.

начиная с версии 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);

выдаёт поля которые необходимо заполнить в структуре помещаемой в gtk_recent_filter_filter()

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

начиная с версии 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().

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

начиная с версии 2.10

смотрите также

gtkrecentchooser