| |
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 last
GtkRecentChooser это интерфейс который может быть реализован виджетами отображающими списки недавно использованных файлов. В 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-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |