GtkRecentManager

gtk_recent_manager_new ()

GtkRecentManager *
gtk_recent_manager_new (void);

Создаёт новый объект менеджера недавно использовавшихся ресурсов. Объекты менеджеров недавно использовавшихся ресурсов используются для управления списком недавно использовавшихся ресурсов. Объект GtkRecentManager отслеживает список недавно использовавшихся ресурсов и испускает сигнал «changed» каждый раз, когда что-то в списке изменяется.

Объекты GtkRecentManager имеют высокую стоимость: создавайте их только тогда, когда это необходимо. Вместо этого следует использовать gtk_recent_manager_get_default().

С: 2.10

gtk_recent_manager_get_default ()

GtkRecentManager *
gtk_recent_manager_get_default (void);

Возвращает единственный экземпляр объекта GtkRecentManager, который можно использовать в приложении, не беспокоясь об управлении памятью.

С: 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.

С: 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; краткое описание элемента; флаг, указывающий, должен ли элемент считаться частным — т. е. отображаться только приложениями, которые его зарегистрировали.

С: 2.10

gtk_recent_manager_remove_item ()

gboolean
gtk_recent_manager_remove_item (GtkRecentManager *manager,
                                const gchar *uri,
                                GError **error);

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

С: 2.10

gtk_recent_manager_lookup_item ()

GtkRecentInfo *
gtk_recent_manager_lookup_item (GtkRecentManager *manager,
                                const gchar *uri,
                                GError **error);

Ищет URI в списке недавно использовавшихся ресурсов и возвращает GtkRecentInfo, содержащий информацию о ресурсе, такую как его тип MIME или имя для отображения.

С: 2.10

gtk_recent_manager_has_item ()

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

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

С: 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 .

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

С: 2.10

gtk_recent_manager_get_items ()

GList *
gtk_recent_manager_get_items (GtkRecentManager *manager);

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

С: 2.10

gtk_recent_manager_purge_items ()

gint
gtk_recent_manager_purge_items (GtkRecentManager *manager,
                                GError **error);

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

С: 2.10

gtk_recent_info_ref ()

GtkRecentInfo *
gtk_recent_info_ref (GtkRecentInfo *info);

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

С: 2.10

gtk_recent_info_unref ()

void
gtk_recent_info_unref (GtkRecentInfo *info);

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

С: 2.10

gtk_recent_info_get_uri ()

const gchar *
gtk_recent_info_get_uri (GtkRecentInfo *info);

Получает URI ресурса.

С: 2.10

gtk_recent_info_get_display_name ()

const gchar *
gtk_recent_info_get_display_name (GtkRecentInfo *info);

Получает имя ресурса. Если оно не определено, используется имя файла ресурса.

С: 2.10

gtk_recent_info_get_description ()

const gchar *
gtk_recent_info_get_description (GtkRecentInfo *info);

Получает краткое описание ресурса.

С: 2.10

gtk_recent_info_get_mime_type ()

const gchar *
gtk_recent_info_get_mime_type (GtkRecentInfo *info);

Получает MIME-тип ресурса.

С: 2.10

gtk_recent_info_get_added ()

time_t
gtk_recent_info_get_added (GtkRecentInfo *info);

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

С: 2.10

gtk_recent_info_get_modified ()

time_t
gtk_recent_info_get_modified (GtkRecentInfo *info);

Получает метку времени (секунды от эпохи системы), когда метаданные ресурса были в последний раз изменены.

С: 2.10

gtk_recent_info_get_visited ()

time_t
gtk_recent_info_get_visited (GtkRecentInfo *info);

Получает отметку времени (секунды с эпохи системы), когда метаданные ресурса были посещены в последний раз.

С версии: 2.10

gtk_recent_info_get_private_hint ()

gboolean
gtk_recent_info_get_private_hint (GtkRecentInfo *info);

Получает значение флага «private». Ресурсы в списке недавно использованных, у которых этот флаг установлен в TRUE, должны отображаться только приложениями, которые их зарегистрировали.

С версии: 2.10

gtk_recent_info_get_application_info ()

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

Получает данные о приложении, которое зарегистрировало ресурс, на который указывает info .

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

С версии: 2.10

gtk_recent_info_get_applications ()

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

Возвращает список приложений, которые зарегистрировали данный ресурс.

С версии: 2.10

gtk_recent_info_last_application ()

gchar *
gtk_recent_info_last_application (GtkRecentInfo *info);

Получает имя последнего приложения, которое зарегистрировало недавно использованный ресурс, представленный info .

С версии: 2.10

gtk_recent_info_has-application ()

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

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

С версии: 2.10

gtk_recent_info_create_app-info ()

GAppInfo *
gtk_recent_info_create_app_info (GtkRecentInfo *info,
                                 const gchar *app_name,
                                 GError **error);

Создаёт GAppInfo для указанного GtkRecentInfo

gtk_recent_info_get_groups ()

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

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

С: 2.10

gtk_recent_info_has_group ()

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

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

С: 2.10

gtk_recent_info_get_icon ()

GdkPixbuf *
gtk_recent_info_get_icon (GtkRecentInfo *info,
                          gint size);

Возвращает значок размера size, связанный с MIME-типом ресурса.

С: 2.10

gtk_recent_info_get_gicon ()

GIcon *
gtk_recent_info_get_gicon (GtkRecentInfo *info);

Возвращает значок, связанный с MIME-типом ресурса.

С: 2.22

gtk_recent_info_get_short_name ()

gchar *
gtk_recent_info_get_short_name (GtkRecentInfo *info);

Вычисляет допустимую строку UTF-8, которую можно использовать в качестве имени элемента в меню или списке. Например, вызов этой функции для элемента, ссылающегося на «file:///foo/bar.txt», вернёт «bar.txt».

С: 2.10

gtk_recent_info_get_uri_display ()

gchar *
gtk_recent_info_get_uri_display (GtkRecentInfo *info);

Получает отображаемую версию URI ресурса. Если ресурс локальный, возвращает локальный путь; если ресурс не локальный, возвращает кодированное в UTF-8 содержимое gtk_recent_info_get_uri().

С: 2.10

gtk_recent_info_get_age ()

gint
gtk_recent_info_get_age (GtkRecentInfo *info);

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

С: 2.10

gtk_recent_info_is_local ()

gboolean
gtk_recent_info_is_local (GtkRecentInfo *info);

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

С: 2.10

gtk_recent_info_exists ()

gboolean
gtk_recent_info_exists (GtkRecentInfo *info);

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

С: 2.10

gtk_recent_info_match ()

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

Проверяет, указывают ли два объекта GtkRecentInfo на один и тот же ресурс.

С: 2.10