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 |
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”.
- newtype MessageDialog = MessageDialog (ManagedPtr MessageDialog)
- class GObject o => IsMessageDialog o
- toMessageDialog :: IsMessageDialog o => o -> IO MessageDialog
- noMessageDialog :: Maybe MessageDialog
- data MessageDialogGetImageMethodInfo
- messageDialogGetImage :: (HasCallStack, MonadIO m, IsMessageDialog a) => a -> m Widget
- data MessageDialogGetMessageAreaMethodInfo
- messageDialogGetMessageArea :: (HasCallStack, MonadIO m, IsMessageDialog a) => a -> m Widget
- data MessageDialogSetImageMethodInfo
- messageDialogSetImage :: (HasCallStack, MonadIO m, IsMessageDialog a, IsWidget b) => a -> b -> m ()
- data MessageDialogSetMarkupMethodInfo
- messageDialogSetMarkup :: (HasCallStack, MonadIO m, IsMessageDialog a) => a -> Text -> m ()
- data MessageDialogButtonsPropertyInfo
- constructMessageDialogButtons :: IsMessageDialog o => ButtonsType -> IO (GValueConstruct o)
- messageDialogButtons :: AttrLabelProxy "buttons"
- data MessageDialogImagePropertyInfo
- constructMessageDialogImage :: (IsMessageDialog o, IsWidget a) => a -> IO (GValueConstruct o)
- getMessageDialogImage :: (MonadIO m, IsMessageDialog o) => o -> m Widget
- messageDialogImage :: AttrLabelProxy "image"
- setMessageDialogImage :: (MonadIO m, IsMessageDialog o, IsWidget a) => o -> a -> m ()
- data MessageDialogMessageAreaPropertyInfo
- getMessageDialogMessageArea :: (MonadIO m, IsMessageDialog o) => o -> m Widget
- messageDialogMessageArea :: AttrLabelProxy "messageArea"
- data MessageDialogMessageTypePropertyInfo
- constructMessageDialogMessageType :: IsMessageDialog o => MessageType -> IO (GValueConstruct o)
- getMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> m MessageType
- messageDialogMessageType :: AttrLabelProxy "messageType"
- setMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> MessageType -> m ()
- data MessageDialogSecondaryTextPropertyInfo
- clearMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> m ()
- constructMessageDialogSecondaryText :: IsMessageDialog o => Text -> IO (GValueConstruct o)
- getMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> m (Maybe Text)
- messageDialogSecondaryText :: AttrLabelProxy "secondaryText"
- setMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> Text -> m ()
- data MessageDialogSecondaryUseMarkupPropertyInfo
- constructMessageDialogSecondaryUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o)
- getMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool
- messageDialogSecondaryUseMarkup :: AttrLabelProxy "secondaryUseMarkup"
- setMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m ()
- data MessageDialogTextPropertyInfo
- clearMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> m ()
- constructMessageDialogText :: IsMessageDialog o => Text -> IO (GValueConstruct o)
- getMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> m (Maybe Text)
- messageDialogText :: AttrLabelProxy "text"
- setMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> Text -> m ()
- data MessageDialogUseMarkupPropertyInfo
- constructMessageDialogUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o)
- getMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool
- messageDialogUseMarkup :: AttrLabelProxy "useMarkup"
- setMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m ()
Exported types
newtype MessageDialog Source #
GObject MessageDialog Source # | |
IsImplementorIface MessageDialog Source # | |
IsObject MessageDialog Source # | |
IsWindow MessageDialog Source # | |
IsWidget MessageDialog Source # | |
IsDialog MessageDialog Source # | |
IsContainer MessageDialog Source # | |
IsBin MessageDialog Source # | |
IsBuildable MessageDialog Source # | |
IsMessageDialog MessageDialog Source # | |
((~) * info (ResolveMessageDialogMethod t MessageDialog), MethodInfo * info MessageDialog p) => IsLabel t (MessageDialog -> p) Source # | |
((~) * info (ResolveMessageDialogMethod t MessageDialog), MethodInfo * info MessageDialog p) => IsLabelProxy t (MessageDialog -> p) Source # | |
HasAttributeList * MessageDialog Source # | |
type AttributeList MessageDialog Source # | |
type SignalList MessageDialog Source # | |
class GObject o => IsMessageDialog o Source #
toMessageDialog :: IsMessageDialog o => o -> IO MessageDialog Source #
Methods
getImage
data MessageDialogGetImageMethodInfo Source #
((~) * signature (m Widget), MonadIO m, IsMessageDialog a) => MethodInfo * MessageDialogGetImageMethodInfo a signature Source # | |
messageDialogGetImage Source #
:: (HasCallStack, MonadIO m, IsMessageDialog a) | |
=> a |
|
-> 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
data MessageDialogGetMessageAreaMethodInfo Source #
((~) * signature (m Widget), MonadIO m, IsMessageDialog a) => MethodInfo * MessageDialogGetMessageAreaMethodInfo a signature Source # | |
messageDialogGetMessageArea Source #
:: (HasCallStack, MonadIO m, IsMessageDialog a) | |
=> a |
|
-> m Widget | Returns: A |
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
data MessageDialogSetImageMethodInfo Source #
((~) * signature (b -> m ()), MonadIO m, IsMessageDialog a, IsWidget b) => MethodInfo * MessageDialogSetImageMethodInfo a signature Source # | |
messageDialogSetImage Source #
:: (HasCallStack, MonadIO m, IsMessageDialog a, IsWidget b) | |
=> a |
|
-> b |
|
-> m () |
Deprecated: (Since version 3.12)Use Dialog
to create dialogs with images
Sets the dialog’s image to image
.
Since: 2.10
setMarkup
data MessageDialogSetMarkupMethodInfo Source #
((~) * signature (Text -> m ()), MonadIO m, IsMessageDialog a) => MethodInfo * MessageDialogSetMarkupMethodInfo a signature Source # | |
messageDialogSetMarkup Source #
:: (HasCallStack, MonadIO m, IsMessageDialog a) | |
=> a |
|
-> Text |
|
-> 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
data MessageDialogButtonsPropertyInfo Source #
constructMessageDialogButtons :: IsMessageDialog o => ButtonsType -> IO (GValueConstruct o) Source #
messageDialogButtons :: AttrLabelProxy "buttons" Source #
image
data MessageDialogImagePropertyInfo Source #
constructMessageDialogImage :: (IsMessageDialog o, IsWidget a) => a -> IO (GValueConstruct o) Source #
getMessageDialogImage :: (MonadIO m, IsMessageDialog o) => o -> m Widget Source #
messageDialogImage :: AttrLabelProxy "image" Source #
setMessageDialogImage :: (MonadIO m, IsMessageDialog o, IsWidget a) => o -> a -> m () Source #
messageArea
data MessageDialogMessageAreaPropertyInfo Source #
getMessageDialogMessageArea :: (MonadIO m, IsMessageDialog o) => o -> m Widget Source #
messageDialogMessageArea :: AttrLabelProxy "messageArea" Source #
messageType
data MessageDialogMessageTypePropertyInfo Source #
constructMessageDialogMessageType :: IsMessageDialog o => MessageType -> IO (GValueConstruct o) Source #
getMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> m MessageType Source #
messageDialogMessageType :: AttrLabelProxy "messageType" Source #
setMessageDialogMessageType :: (MonadIO m, IsMessageDialog o) => o -> MessageType -> m () Source #
secondaryText
data MessageDialogSecondaryTextPropertyInfo Source #
clearMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> m () Source #
constructMessageDialogSecondaryText :: IsMessageDialog o => Text -> IO (GValueConstruct o) Source #
getMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> m (Maybe Text) Source #
messageDialogSecondaryText :: AttrLabelProxy "secondaryText" Source #
setMessageDialogSecondaryText :: (MonadIO m, IsMessageDialog o) => o -> Text -> m () Source #
secondaryUseMarkup
data MessageDialogSecondaryUseMarkupPropertyInfo Source #
constructMessageDialogSecondaryUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o) Source #
getMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool Source #
messageDialogSecondaryUseMarkup :: AttrLabelProxy "secondaryUseMarkup" Source #
setMessageDialogSecondaryUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m () Source #
text
data MessageDialogTextPropertyInfo Source #
clearMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> m () Source #
constructMessageDialogText :: IsMessageDialog o => Text -> IO (GValueConstruct o) Source #
getMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> m (Maybe Text) Source #
messageDialogText :: AttrLabelProxy "text" Source #
setMessageDialogText :: (MonadIO m, IsMessageDialog o) => o -> Text -> m () Source #
useMarkup
data MessageDialogUseMarkupPropertyInfo Source #
constructMessageDialogUseMarkup :: IsMessageDialog o => Bool -> IO (GValueConstruct o) Source #
getMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> m Bool Source #
messageDialogUseMarkup :: AttrLabelProxy "useMarkup" Source #
setMessageDialogUseMarkup :: (MonadIO m, IsMessageDialog o) => o -> Bool -> m () Source #