| 
 | |
|  | 
| GTK+ Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | | Known Implementations | Properties | Signals | ||||
| GtkRecentChooserGtkRecentChooser Интерфейс реализуемый GtkRecentChooserWidget, GtkRecentChooserMenu и GtkRecentChooserDialog | 
#include <gtk/gtk.h>
            GtkRecentChooser;
            GtkRecentChooserIface;
#define     GTK_RECENT_CHOOSER_ERROR
enum        GtkRecentChooserError;
void        gtk_recent_chooser_set_show_private
                                            (GtkRecentChooser *chooser,
                                             gboolean show_private);
gboolean    gtk_recent_chooser_get_show_private
                                            (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_show_not_found
                                            (GtkRecentChooser *chooser,
                                             gboolean show_not_found);
gboolean    gtk_recent_chooser_get_show_not_found
                                            (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_show_icons
                                            (GtkRecentChooser *chooser,
                                             gboolean show_icons);
gboolean    gtk_recent_chooser_get_show_icons
                                            (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_select_multiple
                                            (GtkRecentChooser *chooser,
                                             gboolean select_multiple);
gboolean    gtk_recent_chooser_get_select_multiple
                                            (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_local_only
                                            (GtkRecentChooser *chooser,
                                             gboolean local_only);
gboolean    gtk_recent_chooser_get_local_only
                                            (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_limit    (GtkRecentChooser *chooser,
                                             gint limit);
gint        gtk_recent_chooser_get_limit    (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_show_tips
                                            (GtkRecentChooser *chooser,
                                             gboolean show_tips);
gboolean    gtk_recent_chooser_get_show_tips
                                            (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_show_numbers
                                            (GtkRecentChooser *chooser,
                                             gboolean show_numbers);
gboolean    gtk_recent_chooser_get_show_numbers
                                            (GtkRecentChooser *chooser);
enum        GtkRecentSortType;
void        gtk_recent_chooser_set_sort_type
                                            (GtkRecentChooser *chooser,
                                             GtkRecentSortType sort_type);
GtkRecentSortType gtk_recent_chooser_get_sort_type
                                            (GtkRecentChooser *chooser);
gint        (*GtkRecentSortFunc)            (GtkRecentInfo *a,
                                             GtkRecentInfo *b,
                                             gpointer user_data);
void        gtk_recent_chooser_set_sort_func
                                            (GtkRecentChooser *chooser,
                                             GtkRecentSortFunc sort_func,
                                             gpointer sort_data,
                                             GDestroyNotify data_destroy);
gboolean    gtk_recent_chooser_set_current_uri
                                            (GtkRecentChooser *chooser,
                                             const gchar *uri,
                                             GError **error);
gchar*      gtk_recent_chooser_get_current_uri
                                            (GtkRecentChooser *chooser);
GtkRecentInfo* gtk_recent_chooser_get_current_item
                                            (GtkRecentChooser *chooser);
gboolean    gtk_recent_chooser_select_uri   (GtkRecentChooser *chooser,
                                             const gchar *uri,
                                             GError **error);
void        gtk_recent_chooser_unselect_uri (GtkRecentChooser *chooser,
                                             const gchar *uri);
void        gtk_recent_chooser_select_all   (GtkRecentChooser *chooser);
void        gtk_recent_chooser_unselect_all (GtkRecentChooser *chooser);
GList*      gtk_recent_chooser_get_items    (GtkRecentChooser *chooser);
gchar**     gtk_recent_chooser_get_uris     (GtkRecentChooser *chooser,
                                             gsize *length);
void        gtk_recent_chooser_add_filter   (GtkRecentChooser *chooser,
                                             GtkRecentFilter *filter);
void        gtk_recent_chooser_remove_filter
                                            (GtkRecentChooser *chooser,
                                             GtkRecentFilter *filter);
GSList*     gtk_recent_chooser_list_filters (GtkRecentChooser *chooser);
void        gtk_recent_chooser_set_filter   (GtkRecentChooser *chooser,
                                             GtkRecentFilter *filter);
GtkRecentFilter* gtk_recent_chooser_get_filter
                                            (GtkRecentChooser *chooser);GInterface +----GtkRecentChooser
GtkRecentChooser требует GtkObject.
GtkRecentChooser реализован в GtkRecentChooserDialog, GtkRecentChooserWidget и GtkRecentChooserMenu.
"filter" GtkRecentFilter : Read / Write "limit" gint : Read / Write "local-only" gboolean : Read / Write "recent-manager" GtkRecentManager : Write / Construct Only "select-multiple" gboolean : Read / Write "show-icons" gboolean : Read / Write "show-not-found" gboolean : Read / Write "show-private" gboolean : Read / Write "show-tips" gboolean : Read / Write "sort-type" GtkRecentSortType : Read / Write
"item-activated"
            void        user_function      (GtkRecentChooser *chooser,
                                            gpointer          user_data)      : Run last
"selection-changed"
            void        user_function      (GtkRecentChooser *chooser,
                                            gpointer          user_data)      : Run lastGtkRecentChooser это интерфейс который может быть реализован виджетами отображающими списки недавно использованных файлов. В GTK+, основными объектами реализующими этот интерфейс являются GtkRecentChooserWidget, GtkRecentChooserDialog и GtkRecentChooserMenu.
Недавно использованные файлы поддерживаются начиная с версии GTK+ 2.10.
typedef struct _GtkRecentChooser GtkRecentChooser;
typedef struct {
  GTypeInterface base_iface;
  
  /*
   * Методы
   */
  gboolean          (* set_current_uri)    (GtkRecentChooser  *chooser,
                                            const gchar       *uri,
                                            GError           **error);
  gchar *           (* get_current_uri)    (GtkRecentChooser  *chooser);
  gboolean          (* select_uri)         (GtkRecentChooser  *chooser,
                                            const gchar       *uri,
                                            GError           **error);
  void              (* unselect_uri)       (GtkRecentChooser  *chooser,
                                            const gchar       *uri);
  void              (* select_all)         (GtkRecentChooser  *chooser);
  void              (* unselect_all)       (GtkRecentChooser  *chooser);
  GList *           (* get_items)          (GtkRecentChooser  *chooser);
  GtkRecentManager *(* get_recent_manager) (GtkRecentChooser  *chooser);
  void              (* add_filter)         (GtkRecentChooser  *chooser,
                                            GtkRecentFilter   *filter);
  void              (* remove_filter)      (GtkRecentChooser  *chooser,
                                            GtkRecentFilter   *filter);
  GSList *          (* list_filters)       (GtkRecentChooser  *chooser);
  void              (* set_sort_func)      (GtkRecentChooser  *chooser,
                                            GtkRecentSortFunc  sort_func,
                                            gpointer           data,
                                            GDestroyNotify     destroy);
  
  /*
   * Сигналы
   */
  void              (* item_activated)     (GtkRecentChooser  *chooser);
  void              (* selection_changed)  (GtkRecentChooser  *chooser);
} GtkRecentChooserIface;
#define GTK_RECENT_CHOOSER_ERROR (gtk_recent_chooser_error_quark ())
Используется для получения объекта GError ошибок GtkRecentChooser.
typedef enum { GTK_RECENT_CHOOSER_ERROR_NOT_FOUND, GTK_RECENT_CHOOSER_ERROR_INVALID_URI } GtkRecentChooserError;
Идентифицирует вариант ошибки которая может произойти во время выполнения функций GtkRecentChooser.
| Указывает что файл не существует | |
| Указывает на неправильный URI | 
void        gtk_recent_chooser_set_show_private
                                            (GtkRecentChooser *chooser,
                                             gboolean show_private);Показывается ли недавно использованный ресурс зарегистрированный как закрытый.
| 
 | |
| 
 | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_get_show_private
                                            (GtkRecentChooser *chooser);
Определяет должен ли chooser
отображать недавно использованные
ресурсы зарегистрированные как закрытые.
| 
 | |
| Возвращает : | 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_show_not_found
                                            (GtkRecentChooser *chooser,
                                             gboolean show_not_found);
Устанавливает должен ли chooser
отображать недавно использованные
ресурсы которые он не находит. Это
применяется только для локальных
ресурсов.
| 
 | |
| 
 | Показывать ли локальные элементы которые мы не нашли | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_get_show_not_found
                                            (GtkRecentChooser *chooser);Определяет должен ли chooser отображать недавно использованные ресурсы которые он не находит.
| 
 | |
| Возвращает : | 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_show_icons
                                            (GtkRecentChooser *chooser,
                                             gboolean show_icons);
Устанавливает должен ли chooser
показывать значок ресурса при отображении.
| 
 | |
| 
 | Должен ли показываться значок рядом с ресурсом | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_get_show_icons
                                            (GtkRecentChooser *chooser);
Определяет показывает ли chooser
значок рядом с ресурсом.
| 
 | |
| Возвращает : | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_select_multiple
                                            (GtkRecentChooser *chooser,
                                             gboolean select_multiple);
Устанавливает может ли chooser
выделять множество элементов.
| 
 | |
| 
 | 
 | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_get_select_multiple
                                            (GtkRecentChooser *chooser);
Определяет может ли chooser
выделять множество элементов.
| 
 | |
| Возвращает : | 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_local_only
                                            (GtkRecentChooser *chooser,
                                             gboolean local_only);
Устанавливает должны ли показываться
только локальные ресурсы, которые
являются ресурсами использующими схему
file://URI, в селекторе недавно использованных
ресурсов. Если local_only это
TRUE
(по умолчанию) то когда отображаемые
ресурсы гарантировано будут доступны
через родную файловую систему.
| 
 | |
| 
 | 
 | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_get_local_only
                                            (GtkRecentChooser *chooser);
Определяет показываются ли только
локальные недавно использованные
ресурсы в селекторе. Смотрите
gtk_recent_chooser_set_local_only()
| 
 | |
| Возвращает : | 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_limit    (GtkRecentChooser *chooser,
                                             gint limit);
Устанавливает количество элементов
которое должны возвращать
gtk_recent_chooser_get_items()
и gtk_recent_chooser_get_uris().
| 
 | |
| 
 | Положительное целое, или -1 означает все элементы. | 
Начиная с версии 2.10
gint gtk_recent_chooser_get_limit (GtkRecentChooser *chooser);
Определяет количество элементов
возвращаемое gtk_recent_chooser_get_items()
и gtk_recent_chooser_get_uris().
| 
 | |
| Возвращает : | Положительное целое, или -1 означающая возвращение всех элементов. | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_show_tips
                                            (GtkRecentChooser *chooser,
                                             gboolean show_tips);Устанавливает показываются ли подсказки в виджете.
| 
 | |
| 
 | 
 | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_get_show_tips
                                            (GtkRecentChooser *chooser);
Определяет должен ли chooser
показывать подсказки.
| 
 | |
| Возвращает : | 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_show_numbers
                                            (GtkRecentChooser *chooser,
                                             gboolean show_numbers);Отображается ли уникальный номер недавно использованного ресурса.
Не используйте эту функцию: используйте
gtk_recent_chooser_menu_set_show_numbers()
вместо неё.
| 
 | |
| 
 | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_get_show_numbers
                                            (GtkRecentChooser *chooser);
Определяет показывается ли номер ресурса
в chooser. 
Не используйте эту функцию: используйте
вместо неё gtk_recent_chooser_menu_get_show_numbers().
| 
 | |
| Возвращает : | 
Начиная с версии 2.10
typedef enum { GTK_RECENT_SORT_NONE = 0, GTK_RECENT_SORT_MRU, GTK_RECENT_SORT_LRU, GTK_RECENT_SORT_CUSTOM } GtkRecentSortType;
Используется для определения метода сортировки применяемого к списку недавно использованных ресурсов.
| Не сортировать список недавно использованных ресурсов. | |
| Сортировать список помещая использованные в последний раз элементы в начало. | |
| Сортировать список помещая использованные в последний раз элементы в конец. | |
| Сортировать список используя функцию
			выборочной сортировки переданную в
			 | 
void        gtk_recent_chooser_set_sort_type
                                            (GtkRecentChooser *chooser,
                                             GtkRecentSortType sort_type);
Изменяет порядок сортировки списка
недавно использованных ресурсов
отображаемых chooser.
| 
 | |
| 
 | Порядок сортировки который должен использовать селектор | 
Начиная с версии 2.10
GtkRecentSortType gtk_recent_chooser_get_sort_type
                                            (GtkRecentChooser *chooser);
Определяет значение установленное
gtk_recent_chooser_set_sort_type().
| 
 | |
| Возвращает : | Порядок сортировки  | 
Начиная с версии 2.10
gint        (*GtkRecentSortFunc)            (GtkRecentInfo *a,
                                             GtkRecentInfo *b,
                                             gpointer user_data);
| 
 | |
| 
 | |
| 
 | |
| Возвращает : | 
void        gtk_recent_chooser_set_sort_func
                                            (GtkRecentChooser *chooser,
                                             GtkRecentSortFunc sort_func,
                                             gpointer sort_data,
                                             GDestroyNotify data_destroy);
Устанавливает функцию сравнения
используемую при сортировки в sort_func.
Если chooser имеет установленный
тип сортировки GTK_RECENT_SORT_CUSTOM
то когда селектор сортирует используя
эту функцию. 
В функцию сравнения будут переданы
две структуры GtkRecentInfo
и sort_data; sort_func
должна возвращать положительное целое
если первый пункт следует перед вторым,
ноль если элементы равны и отрицательное
если первый пункт следует за вторым.
| 
 | |
| 
 | Функция сравнения | 
| 
 | Пользовательские данные помещаемые
			в  | 
| 
 | Разрушающее уведомление для  | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_set_current_uri
                                            (GtkRecentChooser *chooser,
                                             const gchar *uri,
                                             GError **error);
Устанавливает uri как текущий
URI для chooser.
| 
 | |
| 
 | URI | 
| 
 | |
| Возвращает : | 
 | 
Начиная с версии 2.10
gchar*      gtk_recent_chooser_get_current_uri
                                            (GtkRecentChooser *chooser);
Получает текущий выделенный URI в chooser.
| 
 | |
| Возвращает : | Строка содержащая URI. | 
Начиная с версии 2.10
GtkRecentInfo* gtk_recent_chooser_get_current_item
                                            (GtkRecentChooser *chooser);
Получает GtkRecentInfo
выделенный в данный момент в chooser.
| 
 | |
| Возвращает : | GtkRecentInfo.
			Используйте  | 
Начиная с версии 2.10
gboolean    gtk_recent_chooser_select_uri   (GtkRecentChooser *chooser,
                                             const gchar *uri,
                                             GError **error);
Выделяет uri внутри chooser.
| 
 | |
| 
 | URI | 
| 
 | |
| Возвращает : | 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_unselect_uri (GtkRecentChooser *chooser,
                                             const gchar *uri);
Снимает выделение uri внутри
chooser.
| 
 | |
| 
 | URI | 
Начиная с версии 2.10
void gtk_recent_chooser_select_all (GtkRecentChooser *chooser);
Выделяет все элементы внутри chooser,
если chooser поддерживает
множественное выделение.
| 
 | 
Начиная с версии 2.10
void gtk_recent_chooser_unselect_all (GtkRecentChooser *chooser);
Снимает все выделения внутри chooser.
| 
 | 
Начиная с версии 2.10
GList* gtk_recent_chooser_get_items (GtkRecentChooser *chooser);
Получает список недавно использованных ресурсов в форме GtkRecentInfo объектов.
На возвращаемое значение этой функции
влияют свойства "sort-type" и "limit"
chooser.
| 
 | |
| Возвращает : | Список объектов GtkRecentInfo.
			Вы должны использовать  | 
Начиная с версии 2.10
gchar**     gtk_recent_chooser_get_uris     (GtkRecentChooser *chooser,
                                             gsize *length);Определяет URI недавно использованного ресурса.
На возвращаемое значение этой функции
влияют свойства "sort-type" и "limit"
chooser. 
Так как возвращаемый массив заканчивается
NULL,
length может быть NULL.
| 
 | |
| 
 | Место для хранения возвращаемой
			длины списка URI, или  | 
| Возвращает : | 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_add_filter   (GtkRecentChooser *chooser,
                                             GtkRecentFilter *filter);
Добавляет filter в список
GtkRecentFilter объектов
находящихся в chooser. 
Если нет предварительного фильтра
объектов, эта функция вызовет
gtk_recent_chooser_set_filter().
| 
 | |
| 
 | 
Начиная с версии 2.10
void        gtk_recent_chooser_remove_filter
                                            (GtkRecentChooser *chooser,
                                             GtkRecentFilter *filter);
Удаляет filter из списка
GtkRecentFilter объектов
находящихся в chooser.
| 
 | |
| 
 | 
Начиная с версии 2.10
GSList* gtk_recent_chooser_list_filters (GtkRecentChooser *chooser);
Определяет объекты GtkRecentFilter
находящиеся в chooser.
| 
 | |
| Возвращает : | Отдельно связанный список объектов
			GtkRecentFilter. Вы должны
			освободить возвращаемый список
			используя  | 
Начиная с версии 2.10
void        gtk_recent_chooser_set_filter   (GtkRecentChooser *chooser,
                                             GtkRecentFilter *filter);
Устанавливает filter как
текущий GtkRecentFilter
объект используемый chooser
для влияния на отображаемые недавно
использованные ресурсы.
| 
 | |
| 
 | 
Начиная с версии 2.10
GtkRecentFilter* gtk_recent_chooser_get_filter
                                            (GtkRecentChooser *chooser);
Определяет GtkRecentFilter
объект используемый в текущий момент
chooser для влияния на отображаемые
недавно используемые ресурсы.
| 
 | |
| Возвращает : | GtkRecentFilter объект. | 
Начиная с версии 2.10
filter""filter" GtkRecentFilter : Read / Write
Текущий фильтр выделения отображаемых ресурсов.
limit""limit" gint : Read / Write
Максимальное количество элементов для отображения.
Допустимые значения : >= -1
Значение по умолчанию : -1
local-only""local-only" gboolean : Read / Write
Лимитировано ли выделение только локальными ресурсами file://URIs.
Значение по умолчанию : TRUE
recent-manager""recent-manager" GtkRecentManager : Write / Construct Only
Используемый объект RecentManager.
select-multiple""select-multiple" gboolean : Read / Write
Разрешено ли множественное выделение.
Значение по умолчанию : FALSE
show-icons""show-icons" gboolean : Read / Write
Должен ли быть значок рядом с ресурсом.
Значение по умолчанию : TRUE
show-not-found""show-not-found" gboolean : Read / Write
Должен ли отображаться элемент указывающий на недоступный ресурс.
Значение по умолчанию : FALSE
show-private""show-private" gboolean : Read / Write
Должны ли отображаться закрытые ресурсы.
Значение по умолчанию : FALSE
show-tips""show-tips" gboolean : Read / Write
Должны ли элементы иметь подсказки.
Значение по умолчанию : FALSE
sort-type""sort-type" GtkRecentSortType : Read / Write
Порядок сортировки отображаемых элементов.
Значение по умолчанию : GTK_RECENT_SORT_NONE
void        user_function                  (GtkRecentChooser *chooser,
                                            gpointer          user_data)      : Run lastЭтот сигнал издаётся когда пользователь активизирует элемент в селекторе недавно использованных ресурсов. Это может произойти при двойном нажатии (double-clicking) на элементе в списке недавно использованных ресурсов, или нажатием клавиши Enter.
| 
 | Объект получающий сигнал | 
| 
 | Пользовательские данные помещаемые при подключении обработчика сигнала. | 
Начиная с версии 2.10
void        user_function                  (GtkRecentChooser *chooser,
                                            gpointer          user_data)      : Run lastЭтот сигнал издаётся при изменениях в наборе выделенных элементов недавно использованных ресурсов. Это может происходить когда пользователь изменяет выделение мышкой или клавиатурой, или когда вызвана функция для изменения выделения.
| 
 | Объект получающий сигнал | 
| 
 | Пользовательские данные помещаемые при подключении обработчика сигнала. | 
Начиная с версии 2.10
GtkRecentManager, GtkRecentChooserDialog, GtkRecentChooserWidget, GtkRecentChooserMenu
| Закладки на сайте Проследить за страницей | Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |