Spec-Zone.ru › GTK 3.22

GtkInfoBar

GtkInfoBar — Сообщать пользователю важные сообщения

Функции

GtkWidget * gtk_info_bar_new ()
GtkWidget * gtk_info_bar_new_with_buttons ()
void gtk_info_bar_add_action_widget ()
GtkWidget * gtk_info_bar_add_button ()
void gtk_info_bar_add_buttons ()
void gtk_info_bar_set_response_sensitive ()
void gtk_info_bar_set_default_response ()
void gtk_info_bar_response ()
void gtk_info_bar_set_message_type ()
GtkMessageType gtk_info_bar_get_message_type ()
GtkWidget * gtk_info_bar_get_action_area ()
GtkWidget * gtk_info_bar_get_content_area ()
gboolean gtk_info_bar_get_show_close_button ()
void gtk_info_bar_set_show_close_button ()

Свойства

GtkMessageType message-type Чтение / Запись / Создание
gboolean show-close-button Чтение / Запись / Создание

Стилизованные свойства

gint action-area-border Чтение
gint button-spacing Чтение
gint content-area-border Чтение
gint content-area-spacing Чтение

Сигналы

void close Действие
void response Выполнить последним

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

struct GtkInfoBar

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBox
                    ╰── GtkInfoBar

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

GtkInfoBar реализует AtkImplementorIface, GtkBuildable и GtkOrientable.

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

#include <gtk/gtk.h>

Описание

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

API GtkInfoBar очень похож на GtkDialog, позволяя добавлять кнопки в область действий с помощью gtk_info_bar_add_button() или gtk_info_bar_new_with_buttons(). Чувствительность виджетов действий можно контролировать с помощью gtk_info_bar_set_response_sensitive(). Для добавления виджетов в основную область содержимого GtkInfoBar используйте gtk_info_bar_get_content_area() и добавьте свои виджеты в контейнер.

Аналогично GtkMessageDialog, содержимое GtkInfoBar может быть классифицировано как сообщение об ошибке, предупреждение, информационное сообщение и т. д. с помощью gtk_info_bar_set_message_type(). GTK+ может использовать тип сообщения для определения способа отображения сообщения.

Простой пример использования GtkInfoBar:

// set up info bar
GtkWidget *widget;
GtkInfoBar *bar;

widget = gtk_info_bar_new ();
bar = GTK_INFO_BAR (bar);

gtk_widget_set_no_show_all (widget, TRUE);
message_label = gtk_label_new ("");
gtk_widget_show (message_label);
content_area = gtk_info_bar_get_content_area (bar);
gtk_container_add (GTK_CONTAINER (content_area),
                   message_label);
gtk_info_bar_add_button (bar,
                         _("_OK"),
                         GTK_RESPONSE_OK);
g_signal_connect (bar,
                  "response",
                  G_CALLBACK (gtk_widget_hide),
                  NULL);
gtk_grid_attach (GTK_GRID (grid),
                 widget,
                 0, 2, 1, 1);

...

// show an error message
gtk_label_set_text (GTK_LABEL (message_label), message);
gtk_info_bar_set_message_type (bar,
                               GTK_MESSAGE_ERROR);
gtk_widget_show (bar);

GtkInfoBar как GtkBuildable

Реализация GtkInfoBar интерфейса GtkBuildable предоставляет область содержимого и область действий как внутренние дочерние элементы с именами «content_area» и «action_area».

GtkInfoBar поддерживает пользовательский элемент <action-widgets>, который может содержать несколько элементов <action-widget>. Атрибут «response» указывает числовой ответ, а содержимое элемента — это идентификатор виджета (который должен быть дочерним элементом диалоговых окон action_area).

CSS-узлы

GtkInfoBar имеет единственный CSS-узел с именем infobar. Узел может получить один из стилей классов .info, .warning, .error или .question, в зависимости от типа сообщения.

Функции

gtk_info_bar_new ()

GtkWidget *
gtk_info_bar_new (void);

Создаёт новый объект GtkInfoBar.

Возвращает

новый объект GtkInfoBar

С момента: 2.18

gtk_info_bar_new_with_buttons ()

GtkWidget *
gtk_info_bar_new_with_buttons (const gchar *first_button_text,
                               ...);

Создаёт новый GtkInfoBar с кнопками. Пара текстовой метки/ID ответа кнопки должны быть перечислены, с указанием NULL в конце списка. Текст кнопки может быть либо ID-константой, например, GTK_STOCK_OK, либо произвольным текстом. ID ответа может быть любым положительным числом или одним из значений перечисления GtkResponseType. Если пользователь нажмёт одну из кнопок диалога, GtkInfoBar выпустит сигнал «response» с соответствующим ID ответа.

Параметры

first_button_text

ID-константа или текст для первой кнопки, или NULL.

[allow-none]

...

ID ответа для первой кнопки, а затем дополнительные кнопки, заканчивая NULL

Возвращает

новый GtkInfoBar

gtk_info_bar_add_action_widget ()

void
gtk_info_bar_add_action_widget (GtkInfoBar *info_bar,
                                GtkWidget *child,
                                gint response_id);

Добавляет активируемое виджет в область действий GtkInfoBar, соединяя обработчик сигналов, который будет выпускать сигнал “response” в области сообщения, когда виджет активируется. Виджет добавляется в конец области действий области сообщения.

Параметры

info_bar

GtkInfoBar

child

активируемый виджет

response_id

ID ответа для child

С момента: 2.18

gtk_info_bar_add_button ()

GtkWidget *
gtk_info_bar_add_button (GtkInfoBar *info_bar,
                         const gchar *button_text,
                         gint response_id);

Добавляет кнопку с заданным текстом и настраивает её так, чтобы нажатие на неё выпустило сигнал «response» с заданным response_id. Кнопка добавляется в конец области действий info bars. Виджет кнопки возвращается, но обычно вам это не нужно.

Параметры

info_bar

GtkInfoBar

button_text

текст кнопки

response_id

ID ответа для кнопки

Возвращает

виджет GtkButton, который был добавлен.

[transfer none][type Gtk.Button]

С момента: 2.18

gtk_info_bar_add_buttons ()

void
gtk_info_bar_add_buttons (GtkInfoBar *info_bar,
                          const gchar *first_button_text,
                          ...);

Добавляет дополнительные кнопки, то же самое, что вызов gtk_info_bar_add_button() многократно. Список переменных аргументов должен быть завершён NULL, как и в gtk_info_bar_new_with_buttons(). Каждая кнопка должна иметь как текст, так и ID ответа.

Параметры

info_bar

GtkInfoBar

first_button_text

текст кнопки или ID-константа

...

ID ответа для первой кнопки, затем дополнительные пары текст-response_id, завершающиеся NULL

С момента: 2.18

gtk_info_bar_set_response_sensitive ()

void
gtk_info_bar_set_response_sensitive (GtkInfoBar *info_bar,
                                     gint response_id,
                                     gboolean setting);

Вызывает gtk_widget_set_sensitive (widget, setting) для каждого виджета в области действий info bars с заданным response_id. Удобный способ сделать кнопки диалога активными/неактивными.

Параметры

info_bar

GtkInfoBar

response_id

ID ответа

setting

ИСТИНА для активного

С момента: 2.18

gtk_info_bar_set_default_response ()

void
gtk_info_bar_set_default_response (GtkInfoBar *info_bar,
                                   gint response_id);

Устанавливает последний виджет в области действий info bar с заданным response_id в качестве виджета по умолчанию для диалога. Нажатие клавиши «Ввод» обычно активирует виджет по умолчанию.

Обратите внимание, что эта функция в настоящее время требует добавления info_bar в иерархию виджетов.

Параметры

info_bar

GtkInfoBar

response_id

ID ответа

С момента: 2.18

gtk_info_bar_response ()

void
gtk_info_bar_response (GtkInfoBar *info_bar,
                       gint response_id);

Выпускает сигнал «response» с заданным response_id .

Параметры

info_bar

GtkInfoBar

response_id

ID ответа

С момента: 2.18

gtk_info_bar_set_message_type ()

void
gtk_info_bar_set_message_type (GtkInfoBar *info_bar,
                               GtkMessageType message_type);

Устанавливает тип сообщения в области сообщения.

GTK+ использует этот тип для определения способа отображения сообщения.

Параметры

info_bar

GtkInfoBar

message_type

GtkMessageType

С момента: 2.18

gtk_info_bar_get_message_type ()

GtkMessageType
gtk_info_bar_get_message_type (GtkInfoBar *info_bar);

Возвращает тип сообщения области сообщения.

Параметры

info_bar

GtkInfoBar

Возвращает

тип сообщения области сообщения.

С момента: 2.18

gtk_info_bar_get_action_area ()

GtkWidget *
gtk_info_bar_get_action_area (GtkInfoBar *info_bar);

Возвращает область действий info_bar .

Параметры

info_bar

a GtkInfoBar

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

область действий.

[transfer none]

С: 2.18

gtk_info_bar_get_content_area ()

GtkWidget *
gtk_info_bar_get_content_area (GtkInfoBar *info_bar);

Возвращает область содержимого info_bar .

Параметры

info_bar

a GtkInfoBar

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

область содержимого.

[transfer none]

С: 2.18

gtk_info_bar_get_show_close_button ()

gboolean
gtk_info_bar_get_show_close_button (GtkInfoBar *info_bar);

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

Параметры

info_bar

a GtkInfoBar

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

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

С: 3.10

gtk_info_bar_set_show_close_button ()

void
gtk_info_bar_set_show_close_button (GtkInfoBar *info_bar,
                                    gboolean setting);

Если true, отображается стандартная кнопка закрытия. При нажатии она генерирует ответ GTK_RESPONSE_CLOSE.

Параметры

info_bar

a GtkInfoBar

setting

TRUE включить кнопку закрытия

С: 3.10

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

struct GtkInfoBar

struct GtkInfoBar;

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

Свойство “message-type”

  “message-type”             GtkMessageType

Тип сообщения.

Тип может использоваться для определения внешнего вида панели информации.

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

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

С: 2.18

Свойство “show-close-button”

  “show-close-button”        gboolean

Включать стандартную кнопку закрытия.

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

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

С: 3.10

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

Свойство стиля “action-area-border”

  “action-area-border”       gint

Ширина границы вокруг области действий панели информации.

GtkInfoBar:action-area-border устарело с версии 3.6 и не должно использоваться в новом коде.

Используйте gtk_container_set_border_width()

Флаги: Чтение

Допустимые значения: >= 0

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

С: 2.18

Свойство стиля “button-spacing”

  “button-spacing”           gint

Интервал между кнопками в области действий панели информации.

GtkInfoBar:button-spacing устарело с версии 3.6 и не должно использоваться в новом коде.

Используйте gtk_box_set_spacing()

Флаги: Чтение

Допустимые значения: >= 0

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

С: 2.18

Свойство стиля “content-area-border”

  “content-area-border”      gint

Ширина границы вокруг области содержимого области содержимого панели информации.

GtkInfoBar:content-area-border устарело с версии 3.6 и не должно использоваться в новом коде.

Используйте gtk_container_set_border_width()

Флаги: Чтение

Допустимые значения: >= 0

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

С: 2.18

Свойство стиля “content-area-spacing”

  “content-area-spacing”     gint

Стандартный интервал между элементами области содержимого панели информации.

GtkInfoBar:content-area-spacing устарело с версии 3.6 и не должно использоваться в новом коде.

Используйте gtk_box_set_spacing()

Флаги: Чтение

Допустимые значения: >= 0

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

С: 2.18

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

Сигнал “close”

void
user_function (GtkInfoBar *arg0,
               gpointer    user_data)

Сигнал ::close — это сигнал привязки клавиш, который генерируется, когда пользователь использует привязку клавиш для закрытия панели информации.

По умолчанию привязкой для этого сигнала является клавиша Escape.

Параметры

user_data

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

Флаги: Действие

С: 2.18

Сигнал “response”

void
user_function (GtkInfoBar *info_bar,
               gint        response_id,
               gpointer    user_data)

Генерируется, когда нажимается виджет действия или программист приложения вызывает gtk_dialog_response(). response_id зависит от того, какой виджет действия был нажат.

Параметры

info_bar

объект, на котором генерируется сигнал

response_id

идентификатор ответа

user_data

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

Флаги: Run Last

С: 2.18

См. также

GtkStatusbar, GtkMessageDialog

© 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/GtkInfoBar.html

Spec-Zone.ru

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