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 gchar *	gtk_app_chooser_button_get_heading ()
void	gtk_app_chooser_button_set_heading ()

Свойства

gchar *	heading	Чтение/Запись
gboolean	show-default-item	Чтение/Запись/Конструктор
gboolean	show-dialog-item	Чтение/Запись/Конструктор

Сигналы

void

custom-item-activated

Содержит детали

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

struct	GtkAppChooserButton
struct	GtkAppChooserButtonClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkComboBox
                        ╰── GtkAppChooserButton

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

GtkAppChooserButton реализует AtkImplementorIface, GtkBuildable, GtkCellLayout, GtkCellEditable и 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».

Функции

gtk_app_chooser_button_new ()

GtkWidget *
gtk_app_chooser_button_new (const gchar *content_type);

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

Параметры

content_type

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

Возвращает

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

С версии: 3.0

gtk_app_chooser_button_append_custom_item ()

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

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

Параметры

self	кнопка выбора приложения GtkAppChooserButton
name	имя пользовательского пункта
label	метка пользовательского пункта
icon	иконка пользовательского пункта

С версии: 3.0

gtk_app_chooser_button_append_separator ()

void
gtk_app_chooser_button_append_separator
                               (GtkAppChooserButton *self);

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

Параметры

self

кнопка выбора приложения GtkAppChooserButton

С версии: 3.0

gtk_app_chooser_button_set_active_custom_item ()

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

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

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

Параметры

self	кнопка выбора приложения GtkAppChooserButton
name	имя пользовательского пункта

С версии: 3.0

gtk_app_chooser_button_get_show_default_item ()

gboolean
gtk_app_chooser_button_get_show_default_item
                               (GtkAppChooserButton *self);

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

Параметры

self

кнопка выбора приложения GtkAppChooserButton

Возвращает

значение свойства «show-default-item»

С версии: 3.2

gtk_app_chooser_button_set_show_default_item ()

void
gtk_app_chooser_button_set_show_default_item
                               (GtkAppChooserButton *self,
                                gboolean setting);

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

Параметры

self	кнопка выбора приложения GtkAppChooserButton
setting	новое значение для свойства «show-default-item»

С версии: 3.2

gtk_app_chooser_button_get_show_dialog_item ()

gboolean
gtk_app_chooser_button_get_show_dialog_item
                               (GtkAppChooserButton *self);

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

Параметры

self

кнопка выбора приложения GtkAppChooserButton

Возвращает

значение свойства «show-dialog-item»

С версии: 3.0

gtk_app_chooser_button_set_show_dialog_item ()

void
gtk_app_chooser_button_set_show_dialog_item
                               (GtkAppChooserButton *self,
                                gboolean setting);

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

Параметры

self	кнопка выбора приложения GtkAppChooserButton
setting	новое значение для свойства «show-dialog-item»

С версии: 3.0

gtk_app_chooser_button_get_heading ()

const gchar *
gtk_app_chooser_button_get_heading (GtkAppChooserButton *self);

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

Параметры

self

кнопка выбора приложения GtkAppChooserButton

Возвращает

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

[nullable]

gtk_app_chooser_button_set_heading ()

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

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

Параметры

self	кнопка выбора приложения GtkAppChooserButton
heading	строка, содержащая разметку Pango

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

Структура GtkAppChooserButton

struct GtkAppChooserButton;

Структура GtkAppChooserButtonClass

struct GtkAppChooserButtonClass {
  GtkComboBoxClass parent_class;


  void (* custom_item_activated) (GtkAppChooserButton *self,
                                  const gchar *item_name);
};

Члены

custom_item_activated ()

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

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

Свойство `“heading”`

  “heading”                  gchar *

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

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

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

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

  “show-default-item”        gboolean

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

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

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

С: 3.2

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

  “show-dialog-item”         gboolean

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

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

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

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

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

void
user_function (GtkAppChooserButton *self,
               gchar               *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.gnome.org/gtk3/3.22/GtkAppChooserButton.html

GtkAppChooserButton

Функции

Свойства

Сигналы

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

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

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

Включения

Описание

Функции

gtk_app_chooser_button_new ()

Параметры

Возвращает

gtk_app_chooser_button_append_custom_item ()

Параметры

gtk_app_chooser_button_append_separator ()

Параметры

gtk_app_chooser_button_set_active_custom_item ()

Параметры

gtk_app_chooser_button_get_show_default_item ()

Параметры

Возвращает

gtk_app_chooser_button_set_show_default_item ()

Параметры

gtk_app_chooser_button_get_show_dialog_item ()

Параметры

Возвращает

gtk_app_chooser_button_set_show_dialog_item ()

Параметры

gtk_app_chooser_button_get_heading ()

Параметры

Возвращает

gtk_app_chooser_button_set_heading ()

Параметры

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

Структура GtkAppChooserButton

Структура GtkAppChooserButtonClass

Члены

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

Свойство “heading”

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

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

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

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

Параметры

Свойство `“heading”`

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

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

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