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);

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

Since: 2.10

gtk_recent_info_get_private_hint ()

gboolean
gtk_recent_info_get_private_hint (GtkRecentInfo *info);

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

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

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

Since: 2.10

gtk_recent_info_get_applications ()

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

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

Since: 2.10

gtk_recent_info_last_application ()

gchar *
gtk_recent_info_last_application (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_has_application ()

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

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

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

Since: 2.10

gtk_recent_info_has_group ()

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

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

Since: 2.10

gtk_recent_info_get_icon ()

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

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

Since: 2.10

gtk_recent_info_get_gicon ()

GIcon *
gtk_recent_info_get_gicon (GtkRecentInfo *info);

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

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

Since: 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().

Since: 2.10

gtk_recent-info_get_age ()

gint
gtk_recent_info_get_age (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_is_local ()

gboolean
gtk_recent_info_is_local (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent_info_exists ()

gboolean
gtk_recent_info_exists (GtkRecentInfo *info);

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

Since: 2.10

gtk_recent-info_match ()

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

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

Since: 2.10