gtk.message_dialog

Module for [MessageDialog] class

class MessageDialog MessageDialogGidBuilder MessageDialogGidBuilderImpl

Types 3

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

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

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()