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 () |
Свойства
| char * | 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);
};
Члены
| Сигнал, генерируемый при активации пользовательского элемента, предварительно добавленного с помощью |
Подробности свойств
Свойство “heading”
“heading” char *
Текст, отображаемый в верхней части диалогового окна, которое можно открыть из кнопки. Строка может содержать разметку Pango.
Владелец: GtkAppChooserButton
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “show-default-item”
“show-default-item” gboolean
Свойство «show-default-item» определяет, будет ли выпадающее меню отображать приложение по умолчанию в верхней части для заданного типа содержимого.
Владелец: GtkAppChooserButton
Флаги: Чтение / Запись / Конструктор
Значение по умолчанию: FALSE
С: 3.2
Свойство “show-dialog-item”
“show-dialog-item” gboolean
Свойство «show-dialog-item» определяет, будет ли выпадающее меню отображать элемент, который при нажатии вызывает GtkAppChooserDialog.
Владелец: GtkAppChooserButton
Флаги: Чтение / Запись / Конструктор
Значение по умолчанию: FALSE
Подробности сигналов
Сигнал “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.gnome.org/gtk3/3.24/GtkAppChooserButton.html