краткое описание#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 last описаниеgtkrecentchooser это интерфейс который может быть реализован виджетами отображающими списки недавно использованных файлов. в gtk+, основными объектами реализующими этот интерфейс являются gtkrecentchooserwidget, gtkrecentchooserdialog и gtkrecentchoosermenu. недавно использованные файлы поддерживаются начиная с версии gtk+ 2.10. деталиgtkrecentchoosertypedef struct _gtkrecentchooser gtkrecentchooser; gtkrecentchooserifacetypedef 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;
gtk_recent_chooser_error#define gtk_recent_chooser_error (gtk_recent_chooser_error_quark ()) используется для получения объекта gerror ошибок gtkrecentchooser. enum gtkrecentchoosererrortypedef enum { gtk_recent_chooser_error_not_found, gtk_recent_chooser_error_invalid_uri } gtkrecentchoosererror; идентифицирует вариант ошибки которая может произойти во время выполнения функций gtkrecentchooser.
gtk_recent_chooser_set_show_private ()void gtk_recent_chooser_set_show_private (gtkrecentchooser *chooser, gboolean show_private); показывается ли недавно использованный ресурс зарегистрированный как закрытый.
начиная с версии 2.10 gtk_recent_chooser_get_show_private ()gboolean gtk_recent_chooser_get_show_private (gtkrecentchooser *chooser);
определяет должен ли
начиная с версии 2.10 gtk_recent_chooser_set_show_not_found ()void gtk_recent_chooser_set_show_not_found (gtkrecentchooser *chooser, gboolean show_not_found);
устанавливает должен ли
начиная с версии 2.10 gtk_recent_chooser_get_show_not_found ()gboolean gtk_recent_chooser_get_show_not_found (gtkrecentchooser *chooser); определяет должен ли chooser отображать недавно использованные ресурсы которые он не находит.
начиная с версии 2.10 gtk_recent_chooser_set_show_icons ()void gtk_recent_chooser_set_show_icons (gtkrecentchooser *chooser, gboolean show_icons);
устанавливает должен ли
начиная с версии 2.10 gtk_recent_chooser_get_show_icons ()gboolean gtk_recent_chooser_get_show_icons (gtkrecentchooser *chooser);
определяет показывает ли
начиная с версии 2.10 gtk_recent_chooser_set_select_multiple ()void gtk_recent_chooser_set_select_multiple (gtkrecentchooser *chooser, gboolean select_multiple);
устанавливает может ли
начиная с версии 2.10 gtk_recent_chooser_get_select_multiple ()gboolean gtk_recent_chooser_get_select_multiple (gtkrecentchooser *chooser);
определяет может ли
начиная с версии 2.10 gtk_recent_chooser_set_local_only ()void gtk_recent_chooser_set_local_only (gtkrecentchooser *chooser, gboolean local_only);
устанавливает должны ли показываться
только локальные ресурсы, которые
являются ресурсами использующими схему
file://uri, в селекторе недавно использованных
ресурсов. если
начиная с версии 2.10 gtk_recent_chooser_get_local_only ()gboolean gtk_recent_chooser_get_local_only (gtkrecentchooser *chooser);
определяет показываются ли только
локальные недавно использованные
ресурсы в селекторе. смотрите
начиная с версии 2.10 gtk_recent_chooser_set_limit ()void gtk_recent_chooser_set_limit (gtkrecentchooser *chooser, gint limit);
устанавливает количество элементов
которое должны возвращать
начиная с версии 2.10 gtk_recent_chooser_get_limit ()gint gtk_recent_chooser_get_limit (gtkrecentchooser *chooser);
определяет количество элементов
возвращаемое
начиная с версии 2.10 gtk_recent_chooser_set_show_tips ()void gtk_recent_chooser_set_show_tips (gtkrecentchooser *chooser, gboolean show_tips); устанавливает показываются ли подсказки в виджете.
начиная с версии 2.10 gtk_recent_chooser_get_show_tips ()gboolean gtk_recent_chooser_get_show_tips (gtkrecentchooser *chooser);
определяет должен ли
начиная с версии 2.10 gtk_recent_chooser_set_show_numbers ()void gtk_recent_chooser_set_show_numbers (gtkrecentchooser *chooser, gboolean show_numbers); отображается ли уникальный номер недавно использованного ресурса. не используйте эту функцию: используйте
начиная с версии 2.10 gtk_recent_chooser_get_show_numbers ()gboolean gtk_recent_chooser_get_show_numbers (gtkrecentchooser *chooser);
определяет показывается ли номер ресурса
в не используйте эту функцию: используйте
вместо неё
начиная с версии 2.10 enum gtkrecentsorttypetypedef enum { gtk_recent_sort_none = 0, gtk_recent_sort_mru, gtk_recent_sort_lru, gtk_recent_sort_custom } gtkrecentsorttype; используется для определения метода сортировки применяемого к списку недавно использованных ресурсов.
gtk_recent_chooser_set_sort_type ()void gtk_recent_chooser_set_sort_type (gtkrecentchooser *chooser, gtkrecentsorttype sort_type);
изменяет порядок сортировки списка
недавно использованных ресурсов
отображаемых
начиная с версии 2.10 gtk_recent_chooser_get_sort_type ()gtkrecentsorttype gtk_recent_chooser_get_sort_type (gtkrecentchooser *chooser);
определяет значение установленное
начиная с версии 2.10 gtkrecentsortfunc ()gint (*gtkrecentsortfunc) (gtkrecentinfo *a, gtkrecentinfo *b, gpointer user_data);
gtk_recent_chooser_set_sort_func ()void gtk_recent_chooser_set_sort_func (gtkrecentchooser *chooser, gtkrecentsortfunc sort_func, gpointer sort_data, gdestroynotify data_destroy);
устанавливает функцию сравнения
используемую при сортировки в в функцию сравнения будут переданы
две структуры gtkrecentinfo
и
начиная с версии 2.10 gtk_recent_chooser_set_current_uri ()gboolean gtk_recent_chooser_set_current_uri (gtkrecentchooser *chooser, const gchar *uri, gerror **error);
устанавливает
начиная с версии 2.10 gtk_recent_chooser_get_current_uri ()gchar* gtk_recent_chooser_get_current_uri (gtkrecentchooser *chooser);
получает текущий выделенный uri в
начиная с версии 2.10 gtk_recent_chooser_get_current_item ()gtkrecentinfo* gtk_recent_chooser_get_current_item (gtkrecentchooser *chooser);
получает gtkrecentinfo
выделенный в данный момент в
начиная с версии 2.10 gtk_recent_chooser_select_uri ()gboolean gtk_recent_chooser_select_uri (gtkrecentchooser *chooser, const gchar *uri, gerror **error);
выделяет
начиная с версии 2.10 gtk_recent_chooser_unselect_uri ()void gtk_recent_chooser_unselect_uri (gtkrecentchooser *chooser, const gchar *uri);
снимает выделение
начиная с версии 2.10 gtk_recent_chooser_select_all ()void gtk_recent_chooser_select_all (gtkrecentchooser *chooser);
выделяет все элементы внутри
начиная с версии 2.10 gtk_recent_chooser_unselect_all ()void gtk_recent_chooser_unselect_all (gtkrecentchooser *chooser);
снимает все выделения внутри
начиная с версии 2.10 gtk_recent_chooser_get_items ()glist* gtk_recent_chooser_get_items (gtkrecentchooser *chooser); получает список недавно использованных ресурсов в форме gtkrecentinfo объектов. на возвращаемое значение этой функции
влияют свойства "sort-type" и "limit"
начиная с версии 2.10 gtk_recent_chooser_get_uris ()gchar** gtk_recent_chooser_get_uris (gtkrecentchooser *chooser, gsize *length); определяет uri недавно использованного ресурса. на возвращаемое значение этой функции
влияют свойства "sort-type" и "limit"
так как возвращаемый массив заканчивается
начиная с версии 2.10 gtk_recent_chooser_add_filter ()void gtk_recent_chooser_add_filter (gtkrecentchooser *chooser, gtkrecentfilter *filter);
добавляет если нет предварительного фильтра
объектов, эта функция вызовет
начиная с версии 2.10 gtk_recent_chooser_remove_filter ()void gtk_recent_chooser_remove_filter (gtkrecentchooser *chooser, gtkrecentfilter *filter);
удаляет
начиная с версии 2.10 gtk_recent_chooser_list_filters ()gslist* gtk_recent_chooser_list_filters (gtkrecentchooser *chooser);
определяет объекты gtkrecentfilter
находящиеся в
начиная с версии 2.10 gtk_recent_chooser_set_filter ()void gtk_recent_chooser_set_filter (gtkrecentchooser *chooser, gtkrecentfilter *filter);
устанавливает
начиная с версии 2.10 gtk_recent_chooser_get_filter ()gtkrecentfilter* gtk_recent_chooser_get_filter (gtkrecentchooser *chooser);
определяет gtkrecentfilter
объект используемый в текущий момент
начиная с версии 2.10 детали свойствсвойство "
|
|
объект получающий сигнал |
|
пользовательские данные помещаемые при подключении обработчика сигнала. |
начиная с версии 2.10
void user_function (gtkrecentchooser *chooser, gpointer user_data) : run last
этот сигнал издаётся при изменениях в наборе выделенных элементов недавно использованных ресурсов. это может происходить когда пользователь изменяет выделение мышкой или клавиатурой, или когда вызвана функция для изменения выделения.
|
объект получающий сигнал |
|
пользовательские данные помещаемые при подключении обработчика сигнала. |
начиная с версии 2.10
gtkrecentmanager, gtkrecentchooserdialog, gtkrecentchooserwidget, gtkrecentchoosermenu