Spec-Zone.ru › GTK 3.20

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 Выполнить сначала
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.

Функции

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+Пробел, Возврат или Enter.

Параметры

self

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

application

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

user_data

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

Флаги: Выполнить сначала

Сигнал “application-selected”

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

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

Параметры

self

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

application

выбранный GAppInfo

user_data

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

Флаги: Выполнить сначала

Сигнал “populate-popup”

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

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

Параметры

self

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

menu

объект GtkMenu для заполнения

application

текущий GAppInfo

user_data

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

Флаги: Выполнить сначала

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

Spec-Zone.ru

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