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