GtkRecentManager

gtk_recent_manager_new ()

GtkRecentManager *
gtk_recent_manager_new (void);

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

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

gtk_recent_manager_get_default ()

GtkRecentManager *
gtk_recent_manager_get_default (void);

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

gtk_recent_manager_add_item ()

gboolean
gtk_recent_manager_add_item (GtkRecentManager *manager,
                             const char *uri);

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

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

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

gtk_recent_manager_add_full ()

gboolean
gtk_recent_manager_add_full (GtkRecentManager *manager,
                             const char *uri,
                             const GtkRecentData *recent_data);

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

Переданный URI будет использоваться для идентификации этого ресурса в списке.

Для регистрации нового недавно использованного ресурса необходимо передать метаданные о ресурсе и URI; метаданные хранятся в GtkRecentData, который должен содержать тип MIME ресурса, указанного URI; имя приложения, которое регистрирует элемент, и командную строку, используемую при запуске элемента.

Необязательно, GtkRecentData может содержать строку UTF-8, используемую при просмотре элемента вместо последнего компонента URI; краткое описание элемента; является ли элемент конфиденциальным — то есть должен отображаться только приложениями, которые его зарегистрировали.

gtk_recent_manager_remove_item ()

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

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

gtk_recent_manager_lookup_item ()

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

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

gtk_recent_manager_has_item ()

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

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

gtk_recent_manager_move_item ()

gboolean
gtk_recent_manager_move_item (GtkRecentManager *manager,
                              const char *uri,
                              const char *new_uri,
                              GError **error);

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

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

gtk_recent_manager_get_items ()

GList *
gtk_recent_manager_get_items (GtkRecentManager *manager);

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

gtk_recent_manager_purge_items ()

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

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

gtk_recent_info_ref ()

GtkRecentInfo *
gtk_recent_info_ref (GtkRecentInfo *info);

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

gtk_recent_info_unref ()

void
gtk_recent_info_unref (GtkRecentInfo *info);

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

gtk_recent_info_get_uri ()

const char *
gtk_recent_info_get_uri (GtkRecentInfo *info);

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

gtk_recent_info_get_display_name ()

const char *
gtk_recent_info_get_display_name (GtkRecentInfo *info);

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

gtk_recent_info_get_description ()

const char *
gtk_recent_info_get_description (GtkRecentInfo *info);

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

gtk_recent_info_get_mime_type ()

const char *
gtk_recent_info_get_mime_type (GtkRecentInfo *info);

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

gtk_recent_info_get_added ()

GDateTime *
gtk_recent_info_get_added (GtkRecentInfo *info);

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

gtk_recent_info_get_modified ()

GDateTime *
gtk_recent_info_get_modified (GtkRecentInfo *info);

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

gtk_recent_info_get_visited ()

GDateTime *
gtk_recent_info_get_visited (GtkRecentInfo *info);

Получает время последнего посещения метаданных ресурса.

gtk_recent_info_get_private_hint ()

gboolean
gtk_recent_info_get_private_hint (GtkRecentInfo *info);

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

gtk_recent_info_get_application_info ()

gboolean
gtk_recent_info_get_application_info (GtkRecentInfo *info,
                                      const char *app_name,
                                      const char **app_exec,
                                      guint *count,
                                      GDateTime **stamp);

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

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

gtk_recent_info_get_applications ()

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

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

gtk_recent_info_last_application ()

char *
gtk_recent_info_last_application (GtkRecentInfo *info);

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

gtk_recent_info_has-application ()

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

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

gtk_recent_info_create-app-info ()

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

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

gtk_recent_info_get-groups ()

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

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

gtk_recent_info_has-group ()

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

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

gtk_recent_info_get_gicon ()

GIcon *
gtk_recent_info_get_gicon (GtkRecentInfo *info);

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

gtk_recent_info_get_short_name ()

char *
gtk_recent_info_get_short_name (GtkRecentInfo *info);

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

gtk_recent_info_get_uri_display ()

char *
gtk_recent_info_get_uri_display (GtkRecentInfo *info);

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

gtk_recent_info_get_age ()

int
gtk_recent_info_get_age (GtkRecentInfo *info);

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

gtk_recent_info_is_local ()

gboolean
gtk_recent_info_is_local (GtkRecentInfo *info);

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

gtk_recent_info_exists ()

gboolean
gtk_recent_info_exists (GtkRecentInfo *info);

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

gtk_recent_info_match ()

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

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