GtkMessageDialog

GtkMessageDialog как GtkBuildable

Реализация GtkMessageDialog интерфейса GtkBuildable экспонирует область сообщения как внутренний дочерний элемент с именем «message_area».

gtk_message_dialog_new ()

GtkWidget *
gtk_message_dialog_new (GtkWindow *parent,
                        GtkDialogFlags flags,
                        GtkMessageType type,
                        GtkButtonsType buttons,
                        const char *message_format,
                        ...);

Создаёт новый диалог с сообщением, являющийся простым диалогом с текстом, который пользователь может увидеть. Когда пользователь нажимает кнопку, генерируется сигнал «response» со значениями ID ответа из GtkResponseType. Подробнее см. GtkDialog.

gtk_message_dialog_new_with_markup ()

GtkWidget *
gtk_message_dialog_new_with_markup (GtkWindow *parent,
                                    GtkDialogFlags flags,
                                    GtkMessageType type,
                                    GtkButtonsType buttons,
                                    const char *message_format,
                                    ...);

Создаёт новый диалог с сообщением, являющийся простым диалогом с текстом, форматированным с помощью языка разметки текста Pango. Когда пользователь нажимает кнопку, генерируется сигнал «response» со значениями ID ответа из GtkResponseType. Подробнее см. GtkDialog.

Специальные XML-символы в аргументах, переданных в эту функцию, автоматически будут экранированы по мере необходимости. (См. g_markup_printf_escaped(), чтобы узнать, как это реализовано.) Обычно это то, что вам нужно, но если у вас есть существующая строка разметки Pango, которую вы хотите использовать буквально как метку, то вам нужно использовать gtk_message_dialog_set_markup() вместо этого, так как вы не можете передать строку разметки ни как формат (она может содержать символы «%»), ни как строковый аргумент.

gtk_message_dialog_set_markup ()

void
gtk_message_dialog_set_markup (GtkMessageDialog *message_dialog,
                               const char *str);

Устанавливает текст диалога с сообщением на str, форматированный с помощью языка разметки текста Pango.

gtk_message_dialog_format_secondary_text ()

void
gtk_message_dialog_format_secondary_text
                               (GtkMessageDialog *message_dialog,
                                const char *message_format,
                                ...);

Устанавливает вторичный текст диалога с сообщением на message_format (в стиле printf()).

gtk_message_dialog_format_secondary_markup ()

void
gtk_message_dialog_format_secondary_markup
                               (GtkMessageDialog *message_dialog,
                                const char *message_format,
                                ...);

Устанавливает вторичный текст диалога с сообщением на message_format (в стиле printf()), форматированный с помощью языка разметки текста Pango.

По недосмотру эта функция не экранирует специальные XML-символы, как gtk_message_dialog_new_with_markup(). Таким образом, если аргументы могут содержать специальные XML-символы, необходимо использовать g_markup_printf_escaped() для их экранирования.

GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT | GTK_DIALOG_MODAL;
dialog = gtk_message_dialog_new (parent_window,
                                 flags,
                                 GTK_MESSAGE_ERROR,
                                 GTK_BUTTONS_CLOSE,
                                 "Error reading “%s”: %s",
                                 filename,
                                 g_strerror (errno));
// Destroy the dialog when the user responds to it
// (e.g. clicks a button)

g_signal_connect (dialog, "response",
                  G_CALLBACK (gtk_window_destroy),
                  NULL);

gtk_message_dialog_get_message_area ()

GtkWidget *
gtk_message_dialog_get_message_area (GtkMessageDialog *message_dialog);

Возвращает область сообщения диалога. Это ящик, в котором упакованы основные и дополнительные метки диалога. Можно добавлять собственные дополнительные элементы в этот ящик, и они будут отображаться ниже этих меток. См. gtk_dialog_get_content_area() для соответствующей функции в родительском GtkDialog.

struct GtkMessageDialog

struct GtkMessageDialog;

перечисление GtkMessageType

Тип сообщения, отображаемого в диалоговом окне.

перечисление GtkButtonsType

Предварительно настроенные наборы кнопок для диалогового окна. Если ни один из вариантов не подходит, просто используйте GTK_BUTTONS_NONE, а затем вызовите gtk_dialog_add_buttons().

Свойство “buttons”

  “buttons”                  GtkButtonsType

Кнопки, отображаемые в диалоговом окне сообщения.

Владелец: GtkMessageDialog

Флаги: Запись / Только для создания

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

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

  “message-area”             GtkWidget *

Объект GtkBox, соответствующий области с сообщением в этом диалоговом окне. Подробное описание этой области см. в gtk_message_dialog_get_message_area().

Владелец: GtkMessageDialog

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

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

  “message-type”             GtkMessageType

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

Владелец: GtkMessageDialog

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

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

Свойство “secondary-text”

  “secondary-text”           char *

Дополнительный текст диалогового окна сообщения.

Владелец: GtkMessageDialog

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

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

Свойство “secondary-use-markup”

  “secondary-use-markup”     gboolean

TRUE если дополнительный текст диалогового окна включает разметку Pango. См. pango_parse_markup().

Владелец: GtkMessageDialog

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

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

Свойство “text”

  “text”                     char *

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

Владелец: GtkMessageDialog

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

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

Свойство “use-markup”

  “use-markup”               gboolean

TRUE если основной текст диалогового окна включает разметку Pango. См. pango_parse_markup().

Владелец: GtkMessageDialog

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

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