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, используемый в списке недавно использованных ресурсов.

Since: 2.10

gtk_recent_manager_get_items ()

GList *
gtk_recent_manager_get_items (GtkRecentManager *manager);

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

Since: 2.10

gtk_recent_manager_purge_items ()

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

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

Since: 2.10

gtk_recent_info_ref ()

GtkRecentInfo *
gtk_recent_info_ref (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_unref ()

void
gtk_recent_info_unref (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_get_uri ()

const gchar *
gtk_recent_info_get_uri (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_get_display_name ()

const gchar *
gtk_recent_info_get_display_name (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_get_description ()

const gchar *
gtk_recent_info_get_description (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_get_mime_type ()

const gchar *
gtk_recent_info_get_mime_type (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_get_added ()

time_t
gtk_recent_info_get_added (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_get_modified ()

time_t
gtk_recent_info_get_modified (GtkRecentInfo *info);

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

Since: 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