| |
|
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 Добавить, Поддержать, Вебмастеру |