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” в значение «true», также включается приложение по умолчанию. Чтобы позволить пользователю выбрать другие приложения, вы можете установить свойство “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.20/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”`