Spec-Zone.ru › GTK 4.0

GtkAppChooserButton

GtkAppChooserButton — Кнопка для запуска диалога выбора приложения

Функции

GtkWidget * gtk_app_chooser_button_new ()
void gtk_app_chooser_button_append_custom_item ()
void gtk_app_chooser_button_append_separator ()
void gtk_app_chooser_button_set_active_custom_item ()
gboolean gtk_app_chooser_button_get_show_default_item ()
void gtk_app_chooser_button_set_show_default_item ()
gboolean gtk_app_chooser_button_get_show_dialog_item ()
void gtk_app_chooser_button_set_show_dialog_item ()
const char * gtk_app_chooser_button_get_heading ()
void gtk_app_chooser_button_set_heading ()
gboolean gtk_app_chooser_button_get_modal ()
void gtk_app_chooser_button_set_modal ()

Свойства

char * heading Чтение / Запись
gboolean modal Чтение / Запись / Создание
gboolean show-default-item Чтение / Запись / Создание
gboolean show-dialog-item Чтение / Запись / Создание

Сигналы

void changed Выполнение последним
void custom-item-activated С деталями

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

GtkAppChooserButton

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkAppChooserButton

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

GtkAppChooserButton реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkAppChooser.

Включаемые файлы

#include <gtk/gtk.h>

Описание

Вьюшка GtkAppChooserButton позволяет пользователю выбрать приложение. Она реализует интерфейс GtkAppChooser.

Изначально GtkAppChooserButton выбирает первое приложение в списке, которое будет либо последним использованным приложением, или, если “show-default-item” TRUE, приложение по умолчанию.

Список приложений, показанных в GtkAppChooserButton, включает рекомендуемые приложения для заданного типа содержимого. Когда “show-default-item” установлено, приложение по умолчанию также включается. Чтобы позволить пользователю выбрать другие приложения, можно установить свойство “show-dialog-item”, что позволяет открыть полный диалог выбора приложения GtkAppChooserDialog.

Можно добавить пользовательские элементы в список, используя gtk_app_chooser_button_append_custom_item(). Эти элементы вызывают отправку сигнала “custom-item-activated” при их выборе.

Для отслеживания изменений в выбранном приложении используйте сигнал “changed”.

Узлы CSS

GtkAppChooserButton имеет один узел CSS с именем “appchooserbutton”.

Функции

gtk_app_chooser_button_new ()

GtkWidget *
gtk_app_chooser_button_new (const char *content_type);

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

Параметры

content_type

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

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

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

gtk_app_chooser_button_append_custom_item ()

void
gtk_app_chooser_button_append_custom_item
                               (GtkAppChooserButton *self,
                                const char *name,
                                const char *label,
                                GIcon *icon);

Добавляет пользовательский элемент в список приложений, отображаемых во всплывающем меню; имя элемента должно быть уникальным для каждого виджета. Клиенты могут использовать предоставленное имя в качестве детали для сигнала “custom-item-activated”, чтобы добавить обратный вызов для активации определенного пользовательского элемента в списке. См. также gtk_app_chooser_button_append_separator().

Параметры

self

a GtkAppChooserButton

name

имя пользовательского элемента

label

метка для пользовательского элемента

icon

значок для пользовательского элемента

gtk_app_chooser_button_append_separator ()

void
gtk_app_chooser_button_append_separator
                               (GtkAppChooserButton *self);

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

Параметры

self

a GtkAppChooserButton

gtk_app_chooser_button_set_active_custom_item ()

void
gtk_app_chooser_button_set_active_custom_item
                               (GtkAppChooserButton *self,
                                const char *name);

Выбирает пользовательский элемент, ранее добавленный с помощью gtk_app_chooser_button_append_custom_item().

Используйте gtk_app_chooser_refresh(), чтобы вернуть выбор в исходное состояние.

Параметры

self

a GtkAppChooserButton

name

имя пользовательского элемента

gtk_app_chooser_button_get_show_default_item ()

gboolean
gtk_app_chooser_button_get_show_default_item
                               (GtkAppChooserButton *self);

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

Параметры

self

a GtkAppChooserButton

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

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

gtk_app_chooser_button_set_show_default_item ()

void
gtk_app_chooser_button_set_show_default_item
                               (GtkAppChooserButton *self,
                                gboolean setting);

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

Параметры

self

a GtkAppChooserButton

setting

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

gtk_app_chooser_button_get_show_dialog_item ()

gboolean
gtk_app_chooser_button_get_show_dialog_item
                               (GtkAppChooserButton *self);

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

Параметры

self

a GtkAppChooserButton

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

значение “show-dialog-item”

gtk_app_chooser_button_set_show_dialog_item ()

void
gtk_app_chooser_button_set_show_dialog_item
                               (GtkAppChooserButton *self,
                                gboolean setting);

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

Параметры

self

a GtkAppChooserButton

setting

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

gtk_app_chooser_button_get_heading ()

const char *
gtk_app_chooser_button_get_heading (GtkAppChooserButton *self);

Возвращает текст для отображения вверху диалогового окна.

Параметры

self

a GtkAppChooserButton

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

текст для отображения вверху диалогового окна, или NULL, в этом случае отображается текст по умолчанию.

[nullable]

gtk_app_chooser_button_set_heading ()

void
gtk_app_chooser_button_set_heading (GtkAppChooserButton *self,
                                    const char *heading);

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

Параметры

self

a GtkAppChooserButton

heading

строка, содержащая разметку Pango

gtk_app_chooser_button_get_modal ()

gboolean
gtk_app_chooser_button_get_modal (GtkAppChooserButton *self);

Получает, является ли диалоговое окно модальным.

Параметры

self

a GtkAppChooserButton

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

TRUE если диалоговое окно модальное

gtk_app_chooser_button_set_modal ()

void
gtk_app_chooser_button_set_modal (GtkAppChooserButton *self,
                                  gboolean modal);

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

Параметры

self

a GtkAppChooserButton

modal

TRUE чтобы сделать диалоговое окно модальным

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

GtkAppChooserButton

typedef struct _GtkAppChooserButton GtkAppChooserButton;

Подробное описание свойств

Свойство “heading”

  “heading”                  char *

Текст, отображаемый в верхней части диалогового окна, которое можно открыть из кнопки. Строка может содержать разметку Pango.

Владелец: GtkAppChooserButton

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

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

Свойство “modal”

  “modal”                    gboolean

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

Владелец: GtkAppChooserButton

Флаги: Чтение / Запись / Создание

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

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

  “show-default-item”        gboolean

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

Владелец: GtkAppChooserButton

Флаги: Чтение / Запись / Создание

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

Свойство “show-dialog-item”

  “show-dialog-item”         gboolean

Свойство “show-dialog-item” определяет, должен ли выпадающий список отображать элемент, который при нажатии вызывает GtkAppChooserDialog.

Владелец: GtkAppChooserButton

Флаги: Чтение / Запись / Создание

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

Подробное описание сигналов

Сигнал “changed”

void
user_function (GtkAppChooserButton *self,
               gpointer             user_data)

Издаётся, когда активное приложение в GtkAppChooserButton изменяется.

Параметры

self

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

user_data

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

Флаги: Выполнять последним

Сигнал “custom-item-activated”

void
user_function (GtkAppChooserButton *self,
               char                *item_name,
               gpointer             user_data)

Издается, когда активируется пользовательский элемент, ранее добавленный с помощью gtk_app_chooser_button_append_custom_item(), из выпадающего меню.

Параметры

self

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

item_name

имя активированного элемента

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/GtkAppChooserButton.html

Spec-Zone.ru

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