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 | С деталями |
Типы и Значения
Иерархия объектов
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 | ||
name | имя пользовательского элемента | |
label | метка для пользовательского элемента | |
icon | значок для пользовательского элемента |
gtk_app_chooser_button_append_separator ()
void
gtk_app_chooser_button_append_separator
(GtkAppChooserButton *self); Добавляет разделитель в список приложений, отображаемых во всплывающем меню.
Параметры
self |
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 | ||
name | имя пользовательского элемента |
gtk_app_chooser_button_get_show_default_item ()
gboolean
gtk_app_chooser_button_get_show_default_item
(GtkAppChooserButton *self); Возвращает текущее значение свойства “show-default-item”.
Параметры
self |
Возвращаемое значение
значение “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 | ||
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 |
Возвращаемое значение
значение “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 | ||
setting | новое значение для “show-dialog-item” |
gtk_app_chooser_button_get_heading ()
const char *
gtk_app_chooser_button_get_heading (GtkAppChooserButton *self); Возвращает текст для отображения вверху диалогового окна.
Параметры
self |
Возвращаемое значение
текст для отображения вверху диалогового окна, или NULL, в этом случае отображается текст по умолчанию.
[nullable]
gtk_app_chooser_button_set_heading ()
void gtk_app_chooser_button_set_heading (GtkAppChooserButton *self,const char *heading);
Устанавливает текст для отображения вверху диалогового окна. Если заголовок не установлен, диалоговое окно отображает текст по умолчанию.
Параметры
self | ||
heading | строка, содержащая разметку Pango |
gtk_app_chooser_button_get_modal ()
gboolean
gtk_app_chooser_button_get_modal (GtkAppChooserButton *self); Получает, является ли диалоговое окно модальным.
Параметры
self |
Возвращаемое значение
TRUE если диалоговое окно модальное
gtk_app_chooser_button_set_modal ()
void gtk_app_chooser_button_set_modal (GtkAppChooserButton *self,gboolean modal);
Устанавливает, должно ли диалоговое окно быть модальным.
Параметры
self | ||
modal |
|
Типы и значения
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