Description:

`GtkMessageDialog` presents a dialog with some message text.

Note:

Use [class@Gtk.AlertDialog] instead

It’s simply a convenience widget; you could construct the equivalent of `GtkMessageDialog` from `GtkDialog` without too much effort, but `GtkMessageDialog` saves typing.

The easiest way to do a modal message dialog is to use the gtk_dialog_modal flag, which will call [ method@Gtk.Window.set_modal] internally. The dialog will prevent interaction with the parent window until it's hidden or destroyed. You can use the [signal@Gtk.Dialog:GtkMessageDialog:response] signal to know when the user dismissed the dialog.

An example for using a modal dialog: ```c 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); ```

You might do a non-modal `GtkMessageDialog` simply by omitting the gtk_dialog_modal flag:

```c 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));

// 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); ```

GtkMessageDialog as GtkBuildable

The `GtkMessageDialog` implementation of the `GtkBuildable` interface exposes the message area as an internal child with the name “message_area”.

Namespace: Gtk

Package: gtk+-2.0

Content:

Properties:

public ButtonsType buttons { construct; }

Set of buttons to display on the dialog.

public Widget image { get; set; }

The image for this dialog.

public Widget message_area { get; }

The `GtkBox` that corresponds to the message area of this dialog.

public MessageType message_type { get; set construct; }

The type of the message.

public string secondary_text { owned get; set; }

The secondary text of the message dialog.

public bool secondary_use_markup { get; set; }

true if the secondary text of the dialog includes Pango markup.

public string text { owned get; set; }

The primary text of the message dialog.

public bool use_markup { get; set; }

true if the primary text of the dialog includes Pango markup.

Creation methods:

public MessageDialog (Window? parent, DialogFlags flags, MessageType type, ButtonsType buttons, string? message_format, ...)

Creates a new message dialog.

public MessageDialog.with_markup (Window? parent, DialogFlags flags, MessageType type, ButtonsType buttons, string message_format, ...)

Creates a new message dialog.

Methods:

public void format_secondary_markup (string message_format, ...)

Sets the secondary text of the message dialog.

public void format_secondary_text (string message_format, ...)

Sets the secondary text of the message dialog.

public unowned Widget get_image ()

Gets the dialog’s image.

public unowned Widget get_message_area ()

Returns the message area of the dialog.

public void set_image (Widget image)

Sets the dialog’s image to image.

public void set_markup (string str)

Sets the text of the message dialog.

Fields:

public unowned Widget label

Inherited Members:

All known members inherited from class Gtk.Bin

child

get_child

All known members inherited from class Gtk.Object

user_data

All known members inherited from interface Atk.Implementor

ref_accessible

MessageDialog

Object Hierarchy: