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 gchar *	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	Выполнить сначала
void	populate-popup	Выполнить сначала

Типы и значения

struct	GtkAppChooserWidget
struct	GtkAppChooserWidgetClass

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBox
                    ╰── GtkAppChooserWidget

Реализованные интерфейсы

GtkAppChooserWidget реализует AtkImplementorIface, GtkBuildable, GtkOrientable и 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.

Функции

GtkWidget *
gtk_app_chooser_widget_new (const gchar *content_type);

Создаёт новый GtkAppChooserWidget для приложений, которые могут обрабатывать контент данного типа.

Параметры

content_type

тип контента, для которого нужно показать приложения

Возвращаемое значение

вновь созданный GtkAppChooserWidget

С версии: 3.0

void
gtk_app_chooser_widget_set_show_default
                               (GtkAppChooserWidget *self,
                                gboolean setting);

Устанавливает, должен ли средство выбора приложений отображать обработчик по умолчанию для типа контента в отдельном разделе.

Параметры

self	a GtkAppChooserWidget
setting	новое значение для “show-default”

С версии: 3.0

gboolean
gtk_app_chooser_widget_get_show_default
                               (GtkAppChooserWidget *self);

Возвращает текущее значение свойства “show-default”.

Параметры

self

a GtkAppChooserWidget

Возвращаемое значение

значение “show-default”

С версии: 3.0

void
gtk_app_chooser_widget_set_show_recommended
                               (GtkAppChooserWidget *self,
                                gboolean setting);

Устанавливает, должен ли средство выбора приложений отображать рекомендуемые приложения для типа контента в отдельном разделе.

Параметры

self	a GtkAppChooserWidget
setting	новое значение для “show-recommended”

С версии: 3.0

gboolean
gtk_app_chooser_widget_get_show_recommended
                               (GtkAppChooserWidget *self);

Возвращает текущее значение свойства “show-recommended”.

Параметры

self

a GtkAppChooserWidget

Возвращаемое значение

значение “show-recommended”

С версии: 3.0

void
gtk_app_chooser_widget_set_show_fallback
                               (GtkAppChooserWidget *self,
                                gboolean setting);

Устанавливает, должен ли средство выбора приложений отображать связанные приложения для типа контента в отдельном разделе.

Параметры

self	a GtkAppChooserWidget
setting	новое значение для “show-fallback”

С версии: 3.0

gboolean
gtk_app_chooser_widget_get_show_fallback
                               (GtkAppChooserWidget *self);

Возвращает текущее значение свойства “show-fallback”.

Параметры

self

a GtkAppChooserWidget

Возвращаемое значение

значение “show-fallback”

С версии: 3.0

void
gtk_app_chooser_widget_set_show_other (GtkAppChooserWidget *self,
                                       gboolean setting);

Устанавливает, должен ли средство выбора приложений показывать приложения, не связанные с типом контента.

Параметры

self	a GtkAppChooserWidget
setting	новое значение для “show-other”

С версии: 3.0

gboolean
gtk_app_chooser_widget_get_show_other (GtkAppChooserWidget *self);

Возвращает текущее значение свойства “show-other”.

Параметры

self

a GtkAppChooserWidget

Возвращаемое значение

значение “show-other”

С версии: 3.0

void
gtk_app_chooser_widget_set_show_all (GtkAppChooserWidget *self,
                                     gboolean setting);

Устанавливает, должен ли средство выбора приложений отображать все приложения в плоском списке.

Параметры

self	a GtkAppChooserWidget
setting	новое значение для “show-all”

С версии: 3.0

gboolean
gtk_app_chooser_widget_get_show_all (GtkAppChooserWidget *self);

Возвращает текущее значение свойства “show-all”.

Параметры

self

объект GtkAppChooserWidget

Возвращаемое значение

значение свойства “show-all”

С: 3.0

void
gtk_app_chooser_widget_set_default_text
                               (GtkAppChooserWidget *self,
                                const gchar *text);

Устанавливает текст, отображаемый, если нет приложений, которые могут обработать тип содержимого.

Параметры

self	объект GtkAppChooserWidget
text	новое значение для свойства “default-text”

const gchar *
gtk_app_chooser_widget_get_default_text
                               (GtkAppChooserWidget *self);

Возвращает текст, отображаемый, если нет приложений, которые могут обработать тип содержимого.

Параметры

self

объект GtkAppChooserWidget

Возвращаемое значение

значение свойства “default-text”

С: 3.0

Типы и значения

struct GtkAppChooserWidget

struct GtkAppChooserWidget;

struct GtkAppChooserWidgetClass

struct GtkAppChooserWidgetClass {
  GtkBoxClass parent_class;

  void (* application_selected)  (GtkAppChooserWidget *self,
                                  GAppInfo            *app_info);

  void (* application_activated) (GtkAppChooserWidget *self,
                                  GAppInfo            *app_info);

  void (* populate_popup)        (GtkAppChooserWidget *self,
                                  GtkMenu             *menu,
                                  GAppInfo            *app_info);
};

Члены

`application_selected` ()	Сигнал, генерируемый при выборе элемента приложения из списка виджета.
`application_activated` ()	Сигнал, генерируемый при активации элемента приложения из списка виджета.
`populate_popup` ()	Сигнал, генерируемый при появлении контекстного меню над элементом приложения.

Подробности свойств

Свойство `“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