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.

https://docs.gtk.org/gtk4/messagedialog.png

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#