gtk.message_dialog

Module for MessageDialog class

class MessageDialog MessageDialogGidBuilder MessageDialogGidBuilderImpl

Types 3

classMessageDialog : gtk.dialog.Dialog

gtk.message_dialog.MessageDialog presents a dialog with some message text.

!An example GtkMessageDialog

It’s simply a convenience widget; you could construct the equivalent of gtk.message_dialog.MessageDialog from gtk.dialog.Dialog without too much effort, but gtk.message_dialog.MessageDialog saves typing.

The easiest way to do a modal message dialog is to use the gtk.types.DialogFlags.Modal flag, which will call gtk.window.Window.setModal internally. The dialog will prevent interaction with the parent window until it's hidden or destroyed. You can use the gtk.dialog.Dialog.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 gtk.message_dialog.MessageDialog simply by omitting the gtk.types.DialogFlags.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 gtk.message_dialog.MessageDialog implementation of the gtk.buildable.Buildable interface exposes the message area as an internal child with the name “message_area”.

Deprecated

Use gtk.alert_dialog.AlertDialog instead
Methods
GType _getGType()
GType _gType() @property
MessageDialog self()Returns `this`, for use in `with` statements.
MessageDialogGidBuilder builder()Get builder for [gtk.message_dialog.MessageDialog] Returns: New builder object
gtk.widget.Widget messageArea() @propertyGet `messageArea` property. Returns: The [gtk.box.Box] that corresponds to the message area of this dialog.
gtk.types.MessageType messageType() @propertyGet `messageType` property. Returns: The type of the message.
void messageType(gtk.types.MessageType propval) @propertySet `messageType` property. Params: propval = The type of the message.
string secondaryText() @propertyGet `secondaryText` property. Returns: The secondary text of the message dialog.
void secondaryText(string propval) @propertySet `secondaryText` property. Params: propval = The secondary text of the message dialog.
bool secondaryUseMarkup() @propertyGet `secondaryUseMarkup` property. Returns: true if the secondary text of the dialog includes Pango markup.
void secondaryUseMarkup(bool propval) @propertySet `secondaryUseMarkup` property. Params: propval = true if the secondary text of the dialog includes Pango markup.
string text() @propertyGet `text` property. Returns: The primary text of the message dialog.
void text(string propval) @propertySet `text` property. Params: propval = The primary text of the message dialog.
bool useMarkup() @propertyGet `useMarkup` property. Returns: true if the primary text of the dialog includes Pango markup.
void useMarkup(bool propval) @propertySet `useMarkup` property. Params: propval = true if the primary text of the dialog includes Pango markup.
gtk.widget.Widget getMessageArea()Returns the message area of the dialog.
void setMarkup(string str)Sets the text of the message dialog.
Constructors
this(void * ptr, Flag!"Take" take)
classMessageDialogGidBuilderImpl(T) : gtk.dialog.DialogGidBuilderImpl!T

Fluent builder implementation template for gtk.message_dialog.MessageDialog

Methods
T buttons(gtk.types.ButtonsType propval)
T messageType(gtk.types.MessageType propval)Set `messageType` property. Params: propval = The type of the message. Returns: Builder instance for fluent chaining
T secondaryText(string propval)Set `secondaryText` property. Params: propval = The secondary text of the message dialog. Returns: Builder instance for fluent chaining
T secondaryUseMarkup(bool propval)Set `secondaryUseMarkup` property. Params: propval = true if the secondary text of the dialog includes Pango markup.
T text(string propval)Set `text` property. Params: propval = The primary text of the message dialog.
T useMarkup(bool propval)Set `useMarkup` property. Params: propval = true if the primary text of the dialog includes Pango markup.
classMessageDialogGidBuilder : MessageDialogGidBuilderImpl!MessageDialogGidBuilder

Fluent builder for gtk.message_dialog.MessageDialog

Methods
MessageDialog build()Create object from builder. Returns: New object