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(), так как вы не можете передать строку разметки ни как формат (она может содержать символы «%»), ни как аргумент строки.

C: 2.4

gtk_message_dialog_set_markup ()

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

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

C: 2.4

gtk_message_dialog_set_image ()

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

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

C: 2.10

gtk_message_dialog_get_image ()

GtkWidget *
gtk_message_dialog_get_image (GtkMessageDialog *dialog);

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

C: 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()).

C: 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