gtkrecentmanager

			gtk+ reference manual
top \| description \| object hierarchy \| properties \| signals

gtkrecentmanager — управление недавно используемыми файлами

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

#include <gtk/gtk.h>

            gtkrecentmanager;
            gtkrecentinfo;
            gtkrecentdata;
#define     gtk_recent_manager_error
enum        gtkrecentmanagererror;
gtkrecentmanager* gtk_recent_manager_new    (void);

gtkrecentmanager* gtk_recent_manager_get_default
                                            (void);
gtkrecentmanager* gtk_recent_manager_get_for_screen
                                            (gdkscreen *screen);
void        gtk_recent_manager_set_screen   (gtkrecentmanager *manager,
                                             gdkscreen *screen);

gboolean    gtk_recent_manager_add_item     (gtkrecentmanager *manager,
                                             const gchar *uri);
gboolean    gtk_recent_manager_add_full     (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             const gtkrecentdata *recent_data);

gboolean    gtk_recent_manager_remove_item  (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             gerror **error);
gtkrecentinfo* gtk_recent_manager_lookup_item

                                            (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             gerror **error);
gboolean    gtk_recent_manager_has_item     (gtkrecentmanager *manager,
                                             const gchar *uri);

gboolean    gtk_recent_manager_move_item    (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             const gchar *new_uri,
                                             gerror **error);

gint        gtk_recent_manager_get_limit    (gtkrecentmanager *manager);
void        gtk_recent_manager_set_limit    (gtkrecentmanager *manager,
                                             gint limit);

glist*      gtk_recent_manager_get_items    (gtkrecentmanager *manager);
gint        gtk_recent_manager_purge_items  (gtkrecentmanager *manager,
                                             gerror **error);


gtkrecentinfo* gtk_recent_info_ref          (gtkrecentinfo *info);
void        gtk_recent_info_unref           (gtkrecentinfo *info);
const gchar* gtk_recent_info_get_uri        (gtkrecentinfo *info);
const gchar* gtk_recent_info_get_display_name

                                            (gtkrecentinfo *info);
const gchar* gtk_recent_info_get_description
                                            (gtkrecentinfo *info);
const gchar* gtk_recent_info_get_mime_type  (gtkrecentinfo *info);
time_t      gtk_recent_info_get_added       (gtkrecentinfo *info);
time_t      gtk_recent_info_get_modified    (gtkrecentinfo *info);
time_t      gtk_recent_info_get_visited     (gtkrecentinfo *info);

gboolean    gtk_recent_info_get_private_hint
                                            (gtkrecentinfo *info);
gboolean    gtk_recent_info_get_application_info
                                            (gtkrecentinfo *info,
                                             const gchar *app_name,
                                             gchar **app_exec,
                                             guint *count,
                                             time_t *time_);

gchar**     gtk_recent_info_get_applications
                                            (gtkrecentinfo *info,
                                             gsize *length);
gchar*      gtk_recent_info_last_application
                                            (gtkrecentinfo *info);

gchar**     gtk_recent_info_get_groups      (gtkrecentinfo *info,
                                             gsize *length);
gboolean    gtk_recent_info_has_group       (gtkrecentinfo *info,
                                             const gchar *group_name);

gboolean    gtk_recent_info_has_application (gtkrecentinfo *info,
                                             const gchar *app_name);
gdkpixbuf*  gtk_recent_info_get_icon        (gtkrecentinfo *info,
                                             gint size);

gchar*      gtk_recent_info_get_short_name  (gtkrecentinfo *info);
gchar*      gtk_recent_info_get_uri_display (gtkrecentinfo *info);
gint        gtk_recent_info_get_age         (gtkrecentinfo *info);

gboolean    gtk_recent_info_is_local        (gtkrecentinfo *info);
gboolean    gtk_recent_info_exists          (gtkrecentinfo *info);
gboolean    gtk_recent_info_match           (gtkrecentinfo *info_a,
                                             gtkrecentinfo *info_b);

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

  gobject
   +----gtkrecentmanager

свойства

  "filename"             gchararray            : read / write / construct only
  "limit"                gint                  : read / write
  "size"                 gint                  : read

сигналы

"changed"   void        user_function      (gtkrecentmanager *recent_manager,
                                            gpointer          user_data)           : run first

описание

gtkrecentmanager обеспечивает удобное добавление, удаление и поиск недавно используемых файлов. каждый недавно используемый файл идентифицируется uri, и имеет мета-данные связанные с ним, такие как имена и командные строки приложений которые были зарегистрированы им, число и время каждого приложения имеющего зарегистрированным тот же файл, mime тип файла и должен ли файл отображаться только зарегистрированными им приложениями.

gtkrecentmanager действует как база данных всех недавно используемых файлов. вы можете создать новый объект gtkrecentmanager, но более удобно использовать стандартный менеджер для gdkscreen так как информация о недавно используемых файлах разделяется между разными людьми использующими его. в случае использования экрана по умолчанию, добавление нового недавно используемого файла происходит так:

gtkrecentmanager *manager;

manager = gtk_recent_manager_get_default();
gtk_recent_manager_add_item (manager, file_uri);

поиск недавно используемого файла происходит так:

gtkrecentmanager *manager;
gtkrecentinfo *info;
gerror *error = null;

manager = gtk_recent_manager_get_default();
info = gtk_recent_manager_lookup_item (manager, file_uri, &error);
if (error)
  {
    g_warning ("could not find the file: %s", error->message);
    g_error_free (error);
  }
else
  {
    /* используем информационный объект */
    gtk_recent_info_unref (info);
  }

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

детали

gtkrecentmanager

typedef struct _gtkrecentmanager gtkrecentmanager;

действует как база данных информации о списке недавно используемых файлов. обычно, для получения менеджера недавно используемых файлов для определенного экрана вам нужно использовать gtk_recent_manager_get_for_screen() которая выдаст информацию о текущемм менеджере для этого экрана.

gtkrecentinfo

typedef struct _gtkrecentinfo gtkrecentinfo;

содержит информацию найденную при просмотре ввода списка недавно используемых файлов.

gtkrecentdata

typedef struct {
  gchar *display_name;
  gchar *description;
  
  gchar *mime_type;
  
  gchar *app_name;
  gchar *app_exec;
  
  gchar **groups;
  
  gboolean is_private;
} gtkrecentdata;

мета-данные помещаемые в gtk_recent_manager_add_full() при регистрации недавно используемого ресурса.

мета-данные помещаемые в gtk_recent_manager_add_full(). вы должны использовать gtkrecentdata если вы хотите управлять мета-данными связанными с вводом списка недавно используемых файлов когда вы добавляете в него новый файл.

gchar *`display_name`;	строка в кодировке utf-8, содержит имя недавно используемого ресурса для отображения, или `null`;
gchar *`description`;	строка в кодировке utf-8, содержит короткое описание ресурса, или `null`;
gchar *`mime_type`;	mime тип ресурса;
gchar *`app_name`;	имя приложения которое зарегистрировано с этим недавно использованным ресурсом;
gchar *`app_exec`;	командная строка используемая для запуска этого ресурса; может содержать "`f`" и "`u`" esc символы которые будут дополнять путь ресурсного файла и uri соответственно, когда командная строка найдена;
gchar **`groups`;	вектор строк содержащий имена групп;
gboolean `is_private`;	должен ли ресурс отображаться только приложениями которые зарегистрированы с ним или нет.

gtk_recent_manager_error

#define gtk_recent_manager_error        (gtk_recent_manager_error_quark ())

gquark используемый для gtkrecentmanagererror ошибок.

enum gtkrecentmanagererror

typedef enum
{
  gtk_recent_manager_error_not_found,
  gtk_recent_manager_error_invalid_uri,
  gtk_recent_manager_error_invalid_encoding,
  gtk_recent_manager_error_not_registered,
  gtk_recent_manager_error_read,
  gtk_recent_manager_error_write,
  gtk_recent_manager_error_unknown
} gtkrecentmanagererror;

коды ошибок для gtkrecentmanager операций

`gtk_recent_manager_error_not_found`	определённый uri не существует в списке недавно используемых файлов.
`gtk_recent_manager_error_invalid_uri`	недопустимый uri.
`gtk_recent_manager_error_invalid_encoding`	строка не в кодировке utf-8.
`gtk_recent_manager_error_not_registered`	нет приложения имеющего регистрацию с определенным элементом.
`gtk_recent_manager_error_read`	не удаётся прочесть недавно используемый ресурсный файл.
`gtk_recent_manager_error_write`	не удаётся записать недавно используемый ресурсный файл.
`gtk_recent_manager_error_unknown`	неопределенная ошибка.

gtk_recent_manager_new ()

gtkrecentmanager* gtk_recent_manager_new    (void);

создаёт новый объект менеджера недавно используемых файлов. менеджер используется для обработки недавно используемых ресурсных файлов. gtkrecentmanager объект проверяет список недавно используемых файлов и издаёт сигнал "changed" каждый раз когда список изменяется.

gtkrecentmanager объекты являются экспансивными: убедитесь что создаёте их только когда они необходимы. вы должны использовать gtk_recent_manager_new_for_screen() или gtk_recent_manager_get_default() функции вместо них.

возвращает :

вновь созданный объект gtkrecentmanager.

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

gtk_recent_manager_get_default ()

gtkrecentmanager* gtk_recent_manager_get_default
                                            (void);

выдаёт менеджер для экрана по умолчанию. смотрите gtk_recent_manager_get_for_screen().

возвращает :

уникальный gtkrecentmanager связанный с экраном по умолчанию. этот менеджер связан с экраном и может использоваться пока экран открыт. не нужно делать на него ссылки или отменять их.

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

gtk_recent_manager_get_for_screen ()

gtkrecentmanager* gtk_recent_manager_get_for_screen
                                            (gdkscreen *screen);

выдаёт менеджер связанный с screen; если эта функция вызвана для экрана не созданного предварительно, новый менеджер недавно используемых объектов будет создан и связан с этим экраном. менеджер недавно используемых файлов довольно трудоёмкий для создания, поэтому использование этой функции лучший выбор чем вызов gtk_recent_manager_new() и установка экрана самостоятельно; при использовании этой функции единственный объект управления недавно созданными файлами будет распределен между пользователями.

`screen` :	gdkscreen
возвращает :	уникальный gtkrecentmanager связанный с полученным экраном. этот менеджер связан с экраном и может использоваться пока экран открыт. не нужно делать на него ссылки или отменять их.

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

gtk_recent_manager_set_screen ()

void        gtk_recent_manager_set_screen   (gtkrecentmanager *manager,
                                             gdkscreen *screen);

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

`manager` :	gtkrecentmanager
`screen` :	gdkscreen

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

gtk_recent_manager_add_item ()

gboolean    gtk_recent_manager_add_item     (gtkrecentmanager *manager,
                                             const gchar *uri);

добавляет новый ресурс, указанный uri, в список недавно использованных ресурсов.

эта функция автоматически определяет некоторые необходимые мета-данные и устанавливает другие мета-данные в обычные значения по умолчанию; передаёт данные в gtk_recent_manager_add_full().

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

`manager` :	gtkrecentmanager
`uri` :	допустимый uri
возвращает :	`true` если новый элемент был полностью добавлен в список недавно используемых ресурсов

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

gtk_recent_manager_add_full ()

gboolean    gtk_recent_manager_add_full     (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             const gtkrecentdata *recent_data);

добавляет новый ресурс, указанный uri, в список недавно используемых ресурсов, используя метаданные внутри gtkrecentdata структуры помещенной в recent_data.

помещаемый uri будет использован как идентификатор этого ресурса в списке.

для регистрации нового недавно использованного ресурса, метаданные должны быть помещены так же как uri; метаданные хранятся в структуре gtkrecentdata, которая должна содержать mime тип ресурса указанного uri; имя зарегистрированного приложения и командную строку для запуска этого элемента.

опционально, gtkrecentdata структура может содержать utf-8 строку для использования при просмотре элементов вместо последнего компонента uri; короткое описание элемента; должен ли элемент рассматриваться как закрытый – то есть отображаться только зарегистрированными приложениями.

`manager` :	gtkrecentmanager
`uri` :	допустимый uri
`recent_data` :	метаданные ресурса
возвращает :	`true` если новый элемент был полностью добавлен в список недавно используемых элементов, иначе `false`.

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

gtk_recent_manager_remove_item ()

gboolean    gtk_recent_manager_remove_item  (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             gerror **error);

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

`manager` :	gtkrecentmanager
`uri` :	uri элемента который вы хотите удалить
`error` :	место хранения возвращаемого gerror, или `null`
возвращает :	`true` если элемент указанный `uri` был полностью удалён из списка, а `false` в любом другом случае.

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

gtk_recent_manager_lookup_item ()

gtkrecentinfo* gtk_recent_manager_lookup_item
                                            (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             gerror **error);

ищет uri внутри списка недавно используемых элементов и возвращает структуру содержащую информацию о ресурсе, такую как mime тип, или его отображаемое имя.

`manager` :	gtkrecentmanager
`uri` :	uri
`error` :	место хранения возвращаемого gerror, или `null`
возвращает :	gtkrecentinfo структуру содержащую информацию о ресурсе указанного `uri`, или `null` если uri не был зарегистрирован в списке недавно использованных ресурсов. освобождается с помощью `gtk_recent_info_unref()`.

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

gtk_recent_manager_has_item ()

gboolean    gtk_recent_manager_has_item     (gtkrecentmanager *manager,
                                             const gchar *uri);

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

`manager` :	gtkrecentmanager
`uri` :	uri
возвращает :	`true` ели ресурс был найден, иначе `false`.

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

gtk_recent_manager_move_item ()

gboolean    gtk_recent_manager_move_item    (gtkrecentmanager *manager,
                                             const gchar *uri,
                                             const gchar *new_uri,
                                             gerror **error);

изменяет расположение недавно используемого элемента из uri в new_uri.

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

`manager` :	gtkrecentmanager
`uri` :	uri недавно использованного ресурса
`new_uri` :	новый uri недавно использованного ресурса, или `null` для удаления элемента указанного `uri` из списка
`error` :	место хранения возвращаемого gerror, или `null`
возвращает :	`true` при успешном выполнении.

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

gtk_recent_manager_get_limit ()

gint        gtk_recent_manager_get_limit    (gtkrecentmanager *manager);

выдаёт максимальное количество элементов которое должна вернуть функция gtk_recent_manager_get_items().

`manager` :	gtkrecentmanager
возвращает :	количество возвращаемых элементов, или -1 для возвращения всех элементов.

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

gtk_recent_manager_set_limit ()

void        gtk_recent_manager_set_limit    (gtkrecentmanager *manager,
                                             gint limit);

устанавливает максимальное количество элементов которое должна вернуть функция gtk_recent_manager_get_items(). если limit равен -1, то возвращаются все элементы.

`manager` :	gtkrecentmanager
`limit` :	максимальное число возвращаемых элементов, или -1.

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

gtk_recent_manager_get_items ()

glist*      gtk_recent_manager_get_items    (gtkrecentmanager *manager);

выдаёт список недавно использованных ресурсов.

`manager` :	gtkrecentmanager
возвращает :	список вновь распределённых объектов gtkrecentinfo. используйте `gtk_recent_info_unref()` на каждом элементе списка, а затем освободите сам список используя `g_list_free()`.

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

gtk_recent_manager_purge_items ()

gint        gtk_recent_manager_purge_items  (gtkrecentmanager *manager,
                                             gerror **error);

очищает все элементы из списка недавно использованных ресурсов.

`manager` :	gtkrecentmanager
`error` :	место хранения возвращаемого gerror, или `null`
возвращает :	число элементов удалённых из списка недавно использованных ресурсов.

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

gtk_recent_info_ref ()

gtkrecentinfo* gtk_recent_info_ref          (gtkrecentinfo *info);

увеличивает счет ссылок recent_info на одну.

`info` :	gtkrecentinfo
возвращает :	информация недавно использованных объектов с увеличенным количеством ссылок на одну.

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

gtk_recent_info_unref ()

void        gtk_recent_info_unref           (gtkrecentinfo *info);

уменьшает количество ссылок info на одну. если количество ссылок 0, info де распределяется, а память освобождается.

info :

gtkrecentinfo

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

gtk_recent_info_get_uri ()

const gchar* gtk_recent_info_get_uri        (gtkrecentinfo *info);

выдаёт uri ресурса.

`info` :	gtkrecentinfo
возвращает :	uri ресурса. возвращаемой строкой владеет менеджер и её не нужно освобождать.

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

gtk_recent_info_get_display_name ()

const gchar* gtk_recent_info_get_display_name
                                            (gtkrecentinfo *info);

выдаёт имя ресурса. если нет определённого, выдаётся основное имя ресурса.

`info` :	gtkrecentinfo
возвращает :	отображаемое имя ресурса. возвращаемой строкой владеет менеджер и её не нужно освобождать.

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

gtk_recent_info_get_description ()

const gchar* gtk_recent_info_get_description
                                            (gtkrecentinfo *info);

выдаёт (краткое) описание ресурса.

`info` :	gtkrecentinfo
возвращает :	описание ресурса. возвращаемой строкой владеет менеджер и её не нужно освобождать.

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

gtk_recent_info_get_mime_type ()

const gchar* gtk_recent_info_get_mime_type  (gtkrecentinfo *info);

выдаёт mime тип ресурса.

`info` :	gtkrecentinfo
возвращает :	mime тип ресурса. возвращаемой строкой владеет менеджер и её не нужно освобождать.

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

gtk_recent_info_get_added ()

time_t      gtk_recent_info_get_added       (gtkrecentinfo *info);

выдаёт временной шаблон (в секундах системной эпохи (system's epoch)) когда был добавлен ресурс в список недавно использованных ресурсов.

`info` :	gtkrecentinfo
возвращает :	количество секунд системной эпохи истекших к моменту добавления в список, или -1 при неудаче.

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

gtk_recent_info_get_modified ()

time_t      gtk_recent_info_get_modified    (gtkrecentinfo *info);

выдаёт временной шаблон (в секундах системной эпохи (system's epoch)) когда был изменён список.

`info` :	gtkrecentinfo
возвращает :	количество секунд системной эпохи истекших к моменту добавления в список, или -1 при неудаче.

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

gtk_recent_info_get_visited ()

time_t      gtk_recent_info_get_visited     (gtkrecentinfo *info);

выдаёт временной шаблон (в секундах системной эпохи (system's epoch)) когда был последний раз использован ресурс.

`info` :	gtkrecentinfo
возвращает :	количество секунд системной эпохи истекших с момента добавления в список, или -1 при неудаче.

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

gtk_recent_info_get_private_hint ()

gboolean    gtk_recent_info_get_private_hint
                                            (gtkrecentinfo *info);

выдаёт значение флага "private". недавно использованный ресурс с установленным флагом true должен отображаться только зарегистрированными приложениями.

`info` :	gtkrecentinfo
возвращает :	`true` если флаг закрытости был найден, иначе `false`.

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

gtk_recent_info_get_application_info ()

gboolean    gtk_recent_info_get_application_info
                                            (gtkrecentinfo *info,
                                             const gchar *app_name,
                                             gchar **app_exec,
                                             guint *count,
                                             time_t *time_);

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

если командная строка содержит любые escape символы определенные в спецификации хранения, она будет дополнена.

`info` :	gtkrecentinfo
`app_name` :	имя приложения которое зарегистрировано с этим элементом
`app_exec` :	место хранения возвращаемой строки содержащей команду запуска
`count` :	место хранения возвращаемого значения количества раз регистрации этого элемента
`time_` :	место хранения возвращаемого значения временного шаблона последней регистрации для этого приложения
возвращает :	`true` если приложение с `app_name` имеет регистрацию этого ресурса внутри списка недавно использованных элементов, иначе `false`. вы должны освободить возвращённую командную строку с помощью `g_free()`.

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

gtk_recent_info_get_applications ()

gchar**     gtk_recent_info_get_applications
                                            (gtkrecentinfo *info,
                                             gsize *length);

определяет список приложений зарегистрированных для этого ресурса.

`info` :	gtkrecentinfo
`length` :	место хранения возвращаемого значения длины возвращаемого списка, или `null`
возвращает :	вновь распределенный `null`-завершённый массив строк. используйте `g_strfreev()` для его освобождения.

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

gtk_recent_info_last_application ()

gchar*      gtk_recent_info_last_application
                                            (gtkrecentinfo *info);

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

`info` :	gtkrecentinfo
возвращает :	имя приложения. используйте для его освобождения `g_free()`.

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

gtk_recent_info_get_groups ()

gchar**     gtk_recent_info_get_groups      (gtkrecentinfo *info,
                                             gsize *length);

возвращает все группы зарегистрированные для недавно использованного элемента info. массив возвращаемых имен групп завершается null, поэтому опционально длина может быть null.

`info` :	gtkrecentinfo
`length` :	место хранения возвращаемого значения количества возвращаемых групп, или `null`
возвращает :	вновь распределенный, `null` завершенный массив строк. используйте `g_strfreev()` для его освобождения.

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

gtk_recent_info_has_group ()

gboolean    gtk_recent_info_has_group       (gtkrecentinfo *info,
                                             const gchar *group_name);

контролирует объявляется ли group_name внутри зарегистрированных групп недавно использованного элемента info.

`info` :	gtkrecentinfo
`group_name` :	имя группы
возвращает :	`true` если группа была найдена.

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

gtk_recent_info_has_application ()

gboolean    gtk_recent_info_has_application (gtkrecentinfo *info,
                                             const gchar *app_name);

проверяет зарегистрировано ли приложение ресурсом используя app_name.

`info` :	gtkrecentinfo
`app_name` :	строка содержащая имя приложения
возвращает :	`true` если приложение с именем `app_name` было найдено, иначе `false`.

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

gtk_recent_info_get_icon ()

gdkpixbuf*  gtk_recent_info_get_icon        (gtkrecentinfo *info,
                                             gint size);

определяет размер значка size связанный с ресурсом типа mime.

`info` :	gtkrecentinfo
`size` :	размер значка в пикселах
возвращает :	gdkpixbuf содержащий значок, или `null`.

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

gtk_recent_info_get_short_name ()

gchar*      gtk_recent_info_get_short_name  (gtkrecentinfo *info);

расчитывает допустимую utf-8 строку которая может использоваться как имя элемента в меню или списке. например, вызов этой функции для элемента со ссылкой "file:///foo/bar.txt" выдаст "bar.txt".

`info` :	gtkrecentinfo
возвращает :	вновь распределенная строка в кодировке utf-8; освобождайте её с помощью `g_free()`.

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

gtk_recent_info_get_uri_display ()

gchar*      gtk_recent_info_get_uri_display (gtkrecentinfo *info);

выдаёт отключенную версию ресурсного uri.

`info` :	gtkrecentinfo
возвращает :	utf-8 строка содержащая ресурсный uri или `null`

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

gtk_recent_info_get_age ()

gint        gtk_recent_info_get_age         (gtkrecentinfo *info);

выдаёт количество дней истекших с момента последнего обновления ресурса указанного info.

`info` :	gtkrecentinfo
возвращает :	положительное целое содержащее количество дней истекших с момента последнего изменения ресурса.

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

gtk_recent_info_is_local ()

gboolean    gtk_recent_info_is_local        (gtkrecentinfo *info);

проверяет является ли ресурс локальным или нет, просматривая схему его uri.

`info` :	gtkrecentinfo
возвращает :	`true` если ресурс локальный.

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

gtk_recent_info_exists ()

gboolean    gtk_recent_info_exists          (gtkrecentinfo *info);

проверяет существование ресурса указанного info. в настоящий момент эта проверка работает только для ресурсов указывающих на локальные файлы.

`info` :	gtkrecentinfo
возвращает :	`true` если ресурс существует

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

gtk_recent_info_match ()

gboolean    gtk_recent_info_match           (gtkrecentinfo *info_a,
                                             gtkrecentinfo *info_b);

проверяет указывают ли две структуры gtkrecentinfo на один и тот же ресурс.

`info_a` :	gtkrecentinfo
`info_b` :	gtkrecentinfo
возвращает :	`true` если обе структуры gtkrecentinfo указывают на один и тот же ресурс, иначе `false`.

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

детали свойств

свойство "`filename`"

  "filename"             gchararray            : read / write / construct only

полный путь файла для хранения и чтения в списке недавно использованных ресурсов.

значение по умолчанию : null

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

свойство "`limit`"

  "limit"                gint                  : read / write

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

допустимые значения : >= -1

значение по умолчанию : -1

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

свойство "`size`"

  "size"                 gint                  : read

размер списка недавно использованных ресурсов.

допустимые значения : >= -1

значение по умолчанию : 0

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

детали сигналов

сигнал "changed"

void        user_function                  (gtkrecentmanager *recent_manager,
                                            gpointer          user_data)           : run first

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

`recent_manager` :	менеджер недавно использованных ресурсов
`user_data` :	пользовательские данные помещаемые при подключении обработчика сигнала.

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

gtkrecentmanager

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

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

свойства

сигналы

описание

детали

gtkrecentmanager

gtkrecentinfo

gtkrecentdata

gtk_recent_manager_error

enum gtkrecentmanagererror

gtk_recent_manager_new ()

gtk_recent_manager_get_default ()

gtk_recent_manager_get_for_screen ()

gtk_recent_manager_set_screen ()

gtk_recent_manager_add_item ()

gtk_recent_manager_add_full ()

gtk_recent_manager_remove_item ()

gtk_recent_manager_lookup_item ()

gtk_recent_manager_has_item ()

gtk_recent_manager_move_item ()

gtk_recent_manager_get_limit ()

gtk_recent_manager_set_limit ()

gtk_recent_manager_get_items ()

gtk_recent_manager_purge_items ()

gtk_recent_info_ref ()

gtk_recent_info_unref ()

gtk_recent_info_get_uri ()

gtk_recent_info_get_display_name ()

gtk_recent_info_get_description ()

gtk_recent_info_get_mime_type ()

gtk_recent_info_get_added ()

gtk_recent_info_get_modified ()

gtk_recent_info_get_visited ()

gtk_recent_info_get_private_hint ()

gtk_recent_info_get_application_info ()

gtk_recent_info_get_applications ()

gtk_recent_info_last_application ()

gtk_recent_info_get_groups ()

gtk_recent_info_has_group ()

gtk_recent_info_has_application ()

gtk_recent_info_get_icon ()

gtk_recent_info_get_short_name ()

gtk_recent_info_get_uri_display ()

gtk_recent_info_get_age ()

gtk_recent_info_is_local ()

gtk_recent_info_exists ()

gtk_recent_info_match ()

детали свойств

свойство "filename"

свойство "limit"

свойство "size"

детали сигналов

сигнал "changed"

свойство "`filename`"

свойство "`limit`"

свойство "`size`"