GtkAppChooserWidget
GtkAppChooserWidget — Виджет выбора приложений, который может быть вложен в другие виджеты
Функции
| GtkWidget * | gtk_app_chooser_widget_new () |
| void | gtk_app_chooser_widget_set_show_default () |
| gboolean | gtk_app_chooser_widget_get_show_default () |
| void | gtk_app_chooser_widget_set_show_recommended () |
| gboolean | gtk_app_chooser_widget_get_show_recommended () |
| void | gtk_app_chooser_widget_set_show_fallback () |
| gboolean | gtk_app_chooser_widget_get_show_fallback () |
| void | gtk_app_chooser_widget_set_show_other () |
| gboolean | gtk_app_chooser_widget_get_show_other () |
| void | gtk_app_chooser_widget_set_show_all () |
| gboolean | gtk_app_chooser_widget_get_show_all () |
| void | gtk_app_chooser_widget_set_default_text () |
| const char * | gtk_app_chooser_widget_get_default_text () |
Свойства
| char * | default-text | Чтение / Запись |
| gboolean | show-all | Чтение / Запись / Создание |
| gboolean | show-default | Чтение / Запись / Создание |
| gboolean | show-fallback | Чтение / Запись / Создание |
| gboolean | show-other | Чтение / Запись / Создание |
| gboolean | show-recommended | Чтение / Запись / Создание |
Сигналы
| void | application-activated | Выполнить в первую очередь |
| void | application-selected | Выполнить в первую очередь |
Типы и значения
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkAppChooserWidget
Реализованные интерфейсы
GtkAppChooserWidget реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkAppChooser.
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkAppChooserWidget — это виджет для выбора приложений. Это основной строительный блок для GtkAppChooserDialog. Большинству приложений нужно использовать только последний; но вы можете использовать этот виджет как часть большего виджета, если у вас есть особые потребности.
GtkAppChooserWidget предлагает подробный контроль над тем, какие приложения отображаются, используя свойства “show-default”, “show-recommended”, “show-fallback”, “show-other” и “show-all”. Для получения дополнительной информации об этих группах приложений обратитесь к документации GtkAppChooser.
Чтобы отслеживать выбранное приложение, используйте сигналы “application-selected” и “application-activated”.
Узлы CSS
GtkAppChooserWidget имеет один узел CSS с именем appchooser.
Функции
gtk_app_chooser_widget_new ()
GtkWidget *
gtk_app_chooser_widget_new (const char *content_type); Создаёт новый GtkAppChooserWidget для приложений, которые могут обрабатывать содержимое заданного типа.
Параметры
content_type | тип содержимого, для которого отображаются приложения |
Возвращаемое значение
новый созданный GtkAppChooserWidget
gtk_app_chooser_widget_set_show_default ()
void gtk_app_chooser_widget_set_show_default (GtkAppChooserWidget *self,gboolean setting);
Устанавливает, должен ли выбиратель приложений показывать обработчик по умолчанию для типа содержимого в отдельном разделе.
Параметры
self | ||
setting | новое значение для “show-default” |
gtk_app_chooser_widget_get_show_default ()
gboolean
gtk_app_chooser_widget_get_show_default
(GtkAppChooserWidget *self); Возвращает текущее значение свойства “show-default”.
Параметры
self |
Возвращаемое значение
значение “show-default”
gtk_app_chooser_widget_set_show_recommended ()
void gtk_app_chooser_widget_set_show_recommended (GtkAppChooserWidget *self,gboolean setting);
Устанавливает, должен ли выбиратель приложений отображать рекомендуемые приложения для типа содержимого в отдельном разделе.
Параметры
self | ||
setting | новое значение для “show-recommended” |
gtk_app_chooser_widget_get_show_recommended ()
gboolean
gtk_app_chooser_widget_get_show_recommended
(GtkAppChooserWidget *self); Возвращает текущее значение свойства “show-recommended”.
Параметры
self |
Возвращаемое значение
значение “show-recommended”
gtk_app_chooser_widget_set_show_fallback ()
void gtk_app_chooser_widget_set_show_fallback (GtkAppChooserWidget *self,gboolean setting);
Устанавливает, должен ли выбиратель приложений отображать связанные приложения для типа содержимого в отдельном разделе.
Параметры
self | ||
setting | новое значение для “show-fallback” |
gtk_app_chooser_widget_get_show_fallback ()
gboolean
gtk_app_chooser_widget_get_show_fallback
(GtkAppChooserWidget *self); Возвращает текущее значение свойства “show-fallback”.
Параметры
self |
Возвращаемое значение
значение “show-fallback”
gtk_app_chooser_widget_set_show_other ()
void gtk_app_chooser_widget_set_show_other (GtkAppChooserWidget *self,gboolean setting);
Устанавливает, должен ли выбиратель приложений показывать приложения, не связанные с типом содержимого.
Параметры
self | ||
setting | новое значение для “show-other” |
gtk_app_chooser_widget_get_show_other ()
gboolean
gtk_app_chooser_widget_get_show_other (GtkAppChooserWidget *self); Возвращает текущее значение свойства “show-other”.
Параметры
self |
Возвращаемое значение
значение “show-other”
gtk_app_chooser_widget_set_show_all ()
void gtk_app_chooser_widget_set_show_all (GtkAppChooserWidget *self,gboolean setting);
Устанавливает, должен ли выбиратель приложений отображать все приложения в плоском списке.
Параметры
self | ||
setting | новое значение для “show-all” |
gtk_app_chooser_widget_get_show_all ()
gboolean
gtk_app_chooser_widget_get_show_all (GtkAppChooserWidget *self); Возвращает текущее значение свойства “show-all”.
Параметры
self |
Возвращаемое значение
значение “show-all”
gtk_app_chooser_widget_set_default_text ()
void gtk_app_chooser_widget_set_default_text (GtkAppChooserWidget *self,const char *text);
Устанавливает текст, который отображается, если нет приложений, способных обработать тип содержимого.
Параметры
self | ||
text | новое значение для “default-text” |
gtk_app_chooser_widget_get_default_text ()
const char *
gtk_app_chooser_widget_get_default_text
(GtkAppChooserWidget *self); Возвращает текст, который отображается, если нет приложений, способных обработать тип содержимого.
Параметры
self |
Типы и значения
GtkAppChooserWidget
typedef struct _GtkAppChooserWidget GtkAppChooserWidget;
Подробные сведения о свойствах
Свойство “default-text”
“default-text” char *
Свойство “default-text” определяет текст, отображаемый в виджете, когда для заданного типа содержимого нет приложений. См. также gtk_app_chooser_widget_set_default_text().
Владелец: GtkAppChooserWidget
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “show-all”
“show-all” gboolean
Если свойство “show-all” равно TRUE, выборщик приложений отображает все приложения в одном списке без разделов для стандартных, рекомендуемых или связанных приложений.
Владелец: GtkAppChooserWidget
Флаги: Чтение / Запись / Создание
Значение по умолчанию: FALSE
Свойство “show-default”
“show-default” gboolean
Свойство ::show-default определяет, должен ли выборщик приложений отображать стандартный обработчик для типа содержимого в отдельном разделе. Если FALSE, стандартный обработчик отображается среди рекомендуемых приложений.
Владелец: GtkAppChooserWidget
Флаги: Чтение / Запись / Создание
Значение по умолчанию: FALSE
Свойство “show-fallback”
“show-fallback” gboolean
Свойство “show-fallback” определяет, должен ли выборщик приложений отображать раздел для резервных приложений. Если FALSE, резервные приложения отображаются среди других приложений.
Владелец: GtkAppChooserWidget
Флаги: Чтение / Запись / Создание
Значение по умолчанию: FALSE
Свойство “show-other”
“show-other” gboolean
Свойство “show-other” определяет, должен ли выборщик приложений отображать раздел для других приложений.
Владелец: GtkAppChooserWidget
Флаги: Чтение / Запись / Создание
Значение по умолчанию: FALSE
Свойство “show-recommended”
“show-recommended” gboolean
Свойство “show-recommended” определяет, должен ли выборщик приложений отображать раздел для рекомендуемых приложений. Если FALSE, рекомендуемые приложения отображаются среди других приложений.
Владелец: GtkAppChooserWidget
Флаги: Чтение / Запись / Создание
Значение по умолчанию: TRUE
Подробности сигналов
Сигнал “application-activated”
void user_function (GtkAppChooserWidget *self, GAppInfo *application, gpointer user_data)
Выдается при активации элемента приложения из списка виджета.
Обычно это происходит при двойном щелчке элемента или при выборе элемента и нажатии пользователем клавиши пробела, Shift+пробел, Return или Enter.
Параметры
self | объект, получивший сигнал | |
application | активированное GAppInfo | |
user_data | данные пользователя, установленные при подключении обработчика сигналов. |
Флаги: Выполнить сначала
Сигнал “application-selected”
void user_function (GtkAppChooserWidget *self, GAppInfo *application, gpointer user_data)
Выдается при выборе элемента приложения из списка виджета.
Параметры
self | объект, получивший сигнал | |
application | выбранное GAppInfo | |
user_data | данные пользователя, установленные при подключении обработчика сигналов. |
Флаги: Выполнить сначала
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkAppChooserWidget.html