GtkMessageDialog

gtk_message_dialog_new ()

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

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

gtk_message_dialog_new_with_markup ()

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

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

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

С версии: 2.4

gtk_message_dialog_set_markup ()

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

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

С версии: 2.4

gtk_message_dialog_set_image ()

void
gtk_message_dialog_set_image (GtkMessageDialog *dialog,
                              GtkWidget *image);

Устанавливает изображение диалога в image .

С версии: 2.10

gtk_message_dialog_get_image ()

GtkWidget *
gtk_message_dialog_get_image (GtkMessageDialog *dialog);

Получает изображение диалога.

С версии: 2.14

gtk_message_dialog_format_secondary_text ()

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

Устанавливает дополнительный текст диалога сообщения в message_format (в стиле printf()).

С версии: 2.6

gtk_message_dialog_format_secondary_markup ()

void
gtk_message_dialog_format_secondary_markup
                               (GtkMessageDialog *message_dialog,
                                const gchar *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;
dialog = gtk_message_dialog_new (parent_window,
                                 flags,
                                 GTK_MESSAGE_ERROR,
                                 GTK_BUTTONS_CLOSE,
                                 "Error reading “%s”: %s",
                                 filename,
                                 g_strerror (errno));
gtk_dialog_run (GTK_DIALOG (dialog));
gtk_widget_destroy (dialog);

С версии: 2.6

gtk_message_dialog_get_message_area ()

GtkWidget *
gtk_message_dialog_get_message_area (GtkMessageDialog *message_dialog);

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

С: 2.22