Spec-Zone.ru › GTK 3.22

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 ()

Свойства

gchar * default-text Чтение/Запись
gboolean show-all Чтение/Запись/Создание
gboolean show-default Чтение/Запись/Создание
gboolean show-fallback Чтение/Запись/Создание
gboolean show-other Чтение/Запись/Создание
gboolean show-recommended Чтение/Запись/Создание

Сигналы

void application-activated Run First
void application-selected Run First
void populate-popup Run First

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

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.

Функции

gtk_app_chooser_widget_new ()

GtkWidget *
gtk_app_chooser_widget_new (const gchar *content_type);

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

Параметры

content_type

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

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

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

С версии: 3.0

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”

С версии: 3.0

gtk_app_chooser_widget_get_show_default ()

gboolean
gtk_app_chooser_widget_get_show_default
                               (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

С версии: 3.0

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”

С версии: 3.0

gtk_app_chooser_widget_get_show_recommended ()

gboolean
gtk_app_chooser_widget_get_show_recommended
                               (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

С версии: 3.0

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”

С версии: 3.0

gtk_app_chooser_widget_get_show_fallback ()

gboolean
gtk_app_chooser_widget_get_show_fallback
                               (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

С версии: 3.0

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”

С версии: 3.0

gtk_app_chooser_widget_get_show_other ()

gboolean
gtk_app_chooser_widget_get_show_other (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

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

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

С версии: 3.0

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”

С версии: 3.0

gtk_app_chooser_widget_get_show_all ()

gboolean
gtk_app_chooser_widget_get_show_all (GtkAppChooserWidget *self);

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

Параметры

self

a GtkAppChooserWidget

Возвращает

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

С момента: 3.0

gtk_app_chooser_widget_set_default_text ()

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

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

Параметры

self

a GtkAppChooserWidget

text

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

gtk_app_chooser_widget_get_default_text ()

const gchar *
gtk_app_chooser_widget_get_default_text
                               (GtkAppChooserWidget *self);

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

Параметры

self

a 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”             gchar *

Свойство “default-text” определяет текст, отображаемый в виджете, когда нет приложений для данного типа содержимого. См. также gtk_app_chooser_widget_set_default_text().

Флаги: Чтение/Запись

Значение по умолчанию: NULL

Свойство “show-all”

  “show-all”                 gboolean

Если свойство “show-all” имеет значение TRUE, выбиратель приложения отображает все приложения в едином списке, без разделов для стандартных, рекомендуемых или связанных приложений.

Флаги: Чтение/Запись/Конструктор

Значение по умолчанию: FALSE

Свойство “show-default”

  “show-default”             gboolean

Свойство ::show-default определяет, следует ли выбирателю приложения отображать обработчик по умолчанию для типа содержимого в отдельном разделе. Если FALSE, обработчик по умолчанию перечислен среди рекомендуемых приложений.

Флаги: Чтение/Запись/Конструктор

Значение по умолчанию: FALSE

Свойство “show-fallback”

  “show-fallback”            gboolean

Свойство “show-fallback” определяет, должен ли выбиратель приложения отображать раздел для приложений по умолчанию. Если FALSE, приложения по умолчанию перечислены среди других приложений.

Флаги: Чтение/Запись/Конструктор

Значение по умолчанию: FALSE

Свойство “show-other”

  “show-other”               gboolean

Свойство “show-other” определяет, должен ли выбиратель приложения отображать раздел для других приложений.

Флаги: Чтение/Запись/Конструктор

Значение по умолчанию: FALSE

Свойство “show-recommended”

  “show-recommended”         gboolean

Свойство “show-recommended” определяет, должен ли выбиратель приложения отображать раздел для рекомендуемых приложений. Если FALSE, рекомендуемые приложения перечислены среди других.

Флаги: Чтение/Запись/Конструктор

Значение по умолчанию: TRUE

Сведения о сигналах

Сигнал “application-activated”

void
user_function (GtkAppChooserWidget *self,
               GAppInfo            *application,
               gpointer             user_data)

Выполняется при активации элемента приложения из списка виджета.

Обычно это происходит при двойном щелчке элемента или при выборе элемента и нажатии пользователем клавиш Пробел, Shift+Пробел, Возврат или Ввод.

Параметры

self

объект, получивший сигнал

application

активированный GAppInfo

user_data

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

Флаги: Run First

Сигнал “application-selected”

void
user_function (GtkAppChooserWidget *self,
               GAppInfo            *application,
               gpointer             user_data)

Выполняется при выборе элемента приложения из списка виджета.

Параметры

self

объект, получивший сигнал

application

выбранный GAppInfo

user_data

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

Флаги: Run First

Сигнал “populate-popup”

void
user_function (GtkAppChooserWidget *self,
               GtkMenu             *menu,
               GAppInfo            *application,
               gpointer             user_data)

Выполняется, когда контекстное меню собирается отобразиться над элементом приложения. Клиенты могут добавлять пункты меню в предоставленный объект GtkMenu в обработчике этого сигнала; контекстное меню будет отображено над элементом, если в меню будет добавлен хотя бы один элемент.

Параметры

self

объект, получивший сигнал

menu

контекстное меню GtkMenu для заполнения

application

текущий GAppInfo

user_data

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

Флаги: Run First

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkAppChooserWidget.html

Spec-Zone.ru

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