Copyright	Will Thompson Iñaki García Etxebarria and Jonas Platte
License	LGPL-2.1
Maintainer	Iñaki García Etxebarria (garetxe@gmail.com)
Safe Haskell	None
Language	Haskell2010

GI.Gtk.Objects.MessageDialog

Contents

Exported types
Methods
Properties

Description

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

Synopsis

newtype MessageDialog = MessageDialog (ManagedPtr MessageDialog)
class GObject o => IsMessageDialog o
toMessageDialog :: (MonadIO m, IsMessageDialog o) => o -> m MessageDialog
noMessageDialog :: Maybe MessageDialog
messageDialogGetImage :: (HasCallStack, MonadIO m, IsMessageDialog a) => a -> m Widget
messageDialogGetMessageArea :: (HasCallStack, MonadIO m, IsMessageDialog a) => a -> m Widget
messageDialogSetImage :: (HasCallStack, MonadIO m, IsMessageDialog a, IsWidget b) => a -> b -> m ()
messageDialogSetMarkup :: (HasCallStack, MonadIO m, IsMessageDialog a) => a -> Text -> m ()
constructMessageDialogButtons :: IsMessageDialog o => ButtonsType -> IO (GValueConstruct o)
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 ()
getMessageDialogMessageArea :: (MonadIO m, IsMessageDialog o) => o -> m Widget
constructMessageDialogMessageType :: IsMessageDialog o => MessageType -> IO (GValueConstruct o)
getMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> m MessageType
setMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> MessageType -> m ()
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 ()
constructMessageDialogSecondaryUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o)
getMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool
setMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m ()
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 ()
constructMessageDialogUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o)
getMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool
setMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m ()

Exported types

newtype MessageDialog Source #

Memory-managed wrapper type.

Constructors

MessageDialog (ManagedPtr MessageDialog)

Instances

GObject MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog Methods gobjectType :: MessageDialog -> IO GType #
IsImplementorIface MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsObject MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsBuildable MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsBin MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsContainer MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsDialog MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsWidget MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsWindow MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsMessageDialog MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog

class GObject o => IsMessageDialog o Source #

Type class for types which can be safely cast to MessageDialog, for instance with toMessageDialog.

Instances

(GObject a, (UnknownAncestorError MessageDialog a :: Constraint)) => IsMessageDialog a Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog
IsMessageDialog MessageDialog Source #
Instance details Defined in GI.Gtk.Objects.MessageDialog

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

Cast to MessageDialog, for types for which this is known to be safe. For general casts, use castTo.

noMessageDialog :: Maybe MessageDialog Source #

A convenience alias for Nothing :: Maybe MessageDialog.

Methods

getImage

messageDialogGetImage Source #

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 Source #

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 Source #

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 Source #

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

No description available in the introspection data.

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

Construct a GValueConstruct with valid value for the “buttons” property. This is rarely needed directly, but it is used by new.

image

The image for this dialog.

Since: 2.10

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

Construct a GValueConstruct with valid value for the “image” property. This is rarely needed directly, but it is used by new.

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

Get the value of the “image” property. When overloading is enabled, this is equivalent to

get messageDialog #image

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

Set the value of the “image” property. When overloading is enabled, this is equivalent to

set messageDialog [ #image := value ]

messageArea

The Box that corresponds to the message area of this dialog. See messageDialogGetMessageArea for a detailed description of this area.

Since: 2.22

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

Get the value of the “message-area” property. When overloading is enabled, this is equivalent to

get messageDialog #messageArea

messageType

The type of the message.

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

Construct a GValueConstruct with valid value for the “message-type” property. This is rarely needed directly, but it is used by new.

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

Get the value of the “message-type” property. When overloading is enabled, this is equivalent to

get messageDialog #messageType

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

Set the value of the “message-type” property. When overloading is enabled, this is equivalent to

set messageDialog [ #messageType := value ]

secondaryText

The secondary text of the message dialog.

Since: 2.10

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

Set the value of the “secondary-text” property to Nothing. When overloading is enabled, this is equivalent to

clear #secondaryText

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

Construct a GValueConstruct with valid value for the “secondary-text” property. This is rarely needed directly, but it is used by new.

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

Get the value of the “secondary-text” property. When overloading is enabled, this is equivalent to

get messageDialog #secondaryText

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

Set the value of the “secondary-text” property. When overloading is enabled, this is equivalent to

set messageDialog [ #secondaryText := value ]

secondaryUseMarkup

True if the secondary text of the dialog includes Pango markup. See parseMarkup.

Since: 2.10

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

Construct a GValueConstruct with valid value for the “secondary-use-markup” property. This is rarely needed directly, but it is used by new.

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

Get the value of the “secondary-use-markup” property. When overloading is enabled, this is equivalent to

get messageDialog #secondaryUseMarkup

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

Set the value of the “secondary-use-markup” property. When overloading is enabled, this is equivalent to

set messageDialog [ #secondaryUseMarkup := value ]

text

The primary text of the message dialog. If the dialog has a secondary text, this will appear as the title.

Since: 2.10

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

Set the value of the “text” property to Nothing. When overloading is enabled, this is equivalent to

clear #text

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

Construct a GValueConstruct with valid value for the “text” property. This is rarely needed directly, but it is used by new.

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

Get the value of the “text” property. When overloading is enabled, this is equivalent to

get messageDialog #text

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

Set the value of the “text” property. When overloading is enabled, this is equivalent to

set messageDialog [ #text := value ]

useMarkup

True if the primary text of the dialog includes Pango markup. See parseMarkup.

Since: 2.10

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

Construct a GValueConstruct with valid value for the “use-markup” property. This is rarely needed directly, but it is used by new.

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

Get the value of the “use-markup” property. When overloading is enabled, this is equivalent to

get messageDialog #useMarkup

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

Set the value of the “use-markup” property. When overloading is enabled, this is equivalent to

set messageDialog [ #useMarkup := value ]