Spec-Zone.ru › GTK 4.0

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 Выполнить в первую очередь

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

GtkAppChooserWidget

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

    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

a GtkAppChooserWidget

setting

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

gtk_app_chooser_widget_get_show_default ()

gboolean
gtk_app_chooser_widget_get_show_default
                               (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

gtk_app_chooser_widget_set_show_recommended ()

void
gtk_app_chooser_widget_set_show_recommended
                               (GtkAppChooserWidget *self,
                                gboolean setting);

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

Параметры

self

a GtkAppChooserWidget

setting

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

gtk_app_chooser_widget_get_show_recommended ()

gboolean
gtk_app_chooser_widget_get_show_recommended
                               (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

gtk_app_chooser_widget_set_show_fallback ()

void
gtk_app_chooser_widget_set_show_fallback
                               (GtkAppChooserWidget *self,
                                gboolean setting);

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

Параметры

self

a GtkAppChooserWidget

setting

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

gtk_app_chooser_widget_get_show_fallback ()

gboolean
gtk_app_chooser_widget_get_show_fallback
                               (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

gtk_app_chooser_widget_set_show_other ()

void
gtk_app_chooser_widget_set_show_other (GtkAppChooserWidget *self,
                                       gboolean setting);

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

Параметры

self

a GtkAppChooserWidget

setting

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

gtk_app_chooser_widget_get_show_other ()

gboolean
gtk_app_chooser_widget_get_show_other (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

gtk_app_chooser_widget_set_show_all ()

void
gtk_app_chooser_widget_set_show_all (GtkAppChooserWidget *self,
                                     gboolean setting);

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

Параметры

self

a GtkAppChooserWidget

setting

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

gtk_app_chooser_widget_get_show_all ()

gboolean
gtk_app_chooser_widget_get_show_all (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

gtk_app_chooser_widget_set_default_text ()

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

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

Параметры

self

a GtkAppChooserWidget

text

новое значение для “default-text”

gtk_app_chooser_widget_get_default_text ()

const char *
gtk_app_chooser_widget_get_default_text
                               (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

значение “default-text”.

[nullable]

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API