MessageDialog

Deprecated since version 4.10: Use AlertDialog instead

class MessageDialog(*args, **kwargs)

Superclasses: Dialog, Window, Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager

GtkMessageDialog presents a dialog with some message text.

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 MODAL flag, which will call set_modal internally. The dialog will prevent interaction with the parent window until it’s hidden or destroyed. You can use the response signal to know when the user dismissed the dialog.

An example for using a modal dialog:

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 MODAL flag:

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”.

Methods

class MessageDialog

get_message_area() → Widget

Returns the message area of the dialog.

This is the box where the dialog’s primary and secondary labels are packed. You can add your own extra content to that box and it will appear below those labels. See get_content_area for the corresponding function in the parent Dialog.

Deprecated since version 4.10: Use AlertDialog instead

set_markup(str: str) → None

Sets the text of the message dialog.

Deprecated since version 4.10: Use AlertDialog instead

Parameters:

str – string with Pango markup

Properties

class MessageDialog

props.buttons: ButtonsType

The type of the None singleton.

props.message_area: Widget

The type of the None singleton.

props.message_type: MessageType

The type of the None singleton.

props.secondary_text: str

The type of the None singleton.

props.secondary_use_markup: bool

The type of the None singleton.

props.text: str

The type of the None singleton.

props.use_markup: bool

The type of the None singleton.

Fields

class MessageDialog

parent_instance