GI.Gtk.Objects.MessageDialog

MessageDialog presents a dialog with some message text. It’s simply a convenience widget; you could construct the equivalent of MessageDialog from Dialog without too much effort, but MessageDialog saves typing.

One difference from Dialog is that MessageDialog sets the Window:skip-taskbar-hint property to True, so that the dialog is hidden from the taskbar by default.

The easiest way to do a modal message dialog is to use dialogRun, though you can also pass in the DialogFlagsModal flag, dialogRun automatically makes the dialog modal and waits for the user to respond to it. dialogRun returns when any dialog button is clicked.

An example for using a modal dialog:

C code

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));
gtk_dialog_run (GTK_DIALOG (dialog));
gtk_widget_destroy (dialog);

You might do a non-modal MessageDialog as follows:

An example for a non-modal dialog:

C code

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_swapped (dialog, "response",
                          G_CALLBACK (gtk_widget_destroy),
                          dialog);

GtkMessageDialog as GtkBuildable

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

Exported types

newtype MessageDialog

Constructors

MessageDialog (ManagedPtr MessageDialog)

Instances

GObject MessageDialog

Methods

gobjectType :: MessageDialog -> IO GType

IsImplementorIface MessageDialog

IsObject MessageDialog

IsWindow MessageDialog

IsWidget MessageDialog

IsDialog MessageDialog

IsContainer MessageDialog

IsBin MessageDialog

IsBuildable MessageDialog

IsMessageDialog MessageDialog

class GObject o => IsMessageDialog o

Instances

(GObject a, UnknownAncestorError Constraint MessageDialog a) => IsMessageDialog a

IsMessageDialog MessageDialog

toMessageDialog :: (MonadIO m, IsMessageDialog o) => o -> m MessageDialog

noMessageDialog :: Maybe MessageDialog

Methods

getImage

messageDialogGetImage

Arguments

:: (HasCallStack, MonadIO m, IsMessageDialog a)

=> a

dialog: a MessageDialog

-> m Widget

Returns: the dialog’s image

Deprecated: (Since version 3.12)Use Dialog for dialogs with images

Gets the dialog’s image.

Since: 2.14

getMessageArea

messageDialogGetMessageArea

Arguments

:: (HasCallStack, MonadIO m, IsMessageDialog a)

=> a

messageDialog: a MessageDialog

-> m Widget

Returns: A Box corresponding to the “message area” in the messageDialog.

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 dialogGetContentArea for the corresponding function in the parent Dialog.

Since: 2.22

setImage

messageDialogSetImage

Arguments

:: (HasCallStack, MonadIO m, IsMessageDialog a, IsWidget b)

=> a

dialog: a MessageDialog

-> b

image: the image

-> m ()

Deprecated: (Since version 3.12)Use Dialog to create dialogs with images

Sets the dialog’s image to image.

Since: 2.10

setMarkup

messageDialogSetMarkup

Arguments

:: (HasCallStack, MonadIO m, IsMessageDialog a)

=> a

messageDialog: a MessageDialog

-> Text

str: markup string (see [Pango markup format][PangoMarkupFormat])

-> m ()

Sets the text of the message dialog to be str, which is marked up with the [Pango text markup language][PangoMarkupFormat].

Since: 2.4

Properties

buttons

constructMessageDialogButtons :: IsMessageDialog o => ButtonsType -> IO (GValueConstruct o)

image

constructMessageDialogImage :: (IsMessageDialog o, IsWidget a) => a -> IO (GValueConstruct o)

getMessageDialogImage :: (MonadIO m, IsMessageDialog o) => o -> m Widget

setMessageDialogImage :: (MonadIO m, IsMessageDialog o, IsWidget a) => o -> a -> m ()

messageArea

getMessageDialogMessageArea :: (MonadIO m, IsMessageDialog o) => o -> m Widget

messageType

constructMessageDialogMessageType :: IsMessageDialog o => MessageType -> IO (GValueConstruct o)

getMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> m MessageType

setMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> MessageType -> m ()

secondaryText

clearMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> m ()

constructMessageDialogSecondaryText :: IsMessageDialog o => Text -> IO (GValueConstruct o)

getMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> m (Maybe Text)

setMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> Text -> m ()

secondaryUseMarkup

constructMessageDialogSecondaryUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o)

getMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool

setMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m ()

text

clearMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> m ()

constructMessageDialogText :: IsMessageDialog o => Text -> IO (GValueConstruct o)

getMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> m (Maybe Text)

setMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> Text -> m ()

useMarkup

constructMessageDialogUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o)

getMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool

setMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m ()