Maintainer | gtk2hs-users@lists.sourceforge.net |
---|---|
Stability | provisional |
Portability | portable (depends on GHC) |
Safe Haskell | None |
Language | Haskell98 |
A convenient message window
- data MessageDialog
- class DialogClass o => MessageDialogClass o
- castToMessageDialog :: GObjectClass obj => obj -> MessageDialog
- gTypeMessageDialog :: GType
- toMessageDialog :: MessageDialogClass o => o -> MessageDialog
- data MessageType
- data ButtonsType
- data DialogFlags
- messageDialogNew :: GlibString string => Maybe Window -> [DialogFlags] -> MessageType -> ButtonsType -> string -> IO MessageDialog
- messageDialogNewWithMarkup :: GlibString string => Maybe Window -> [DialogFlags] -> MessageType -> ButtonsType -> string -> IO MessageDialog
- messageDialogSetMarkup :: (MessageDialogClass self, GlibString string) => self -> string -> IO ()
- messageDialogSetImage :: (MessageDialogClass self, WidgetClass image) => self -> image -> IO ()
- messageDialogSetSecondaryMarkup :: (MessageDialogClass self, GlibString string) => self -> string -> IO ()
- messageDialogSetSecondaryText :: (MessageDialogClass self, GlibString string) => self -> string -> IO ()
- messageDialogMessageType :: MessageDialogClass self => Attr self MessageType
- messageDialogText :: (MessageDialogClass self, GlibString string) => Attr self (Maybe string)
- messageDialogUseMarkup :: MessageDialogClass self => Attr self Bool
- messageDialogSecondaryText :: (MessageDialogClass self, GlibString string) => Attr self (Maybe string)
- messageDialogSecondaryUseMarkup :: MessageDialogClass self => Attr self Bool
- messageDialogImage :: (MessageDialogClass self, WidgetClass widget) => ReadWriteAttr self Widget widget
- messageDialogButtons :: MessageDialogClass self => WriteAttr self ButtonsType
- messageDialogMessageArea :: MessageDialogClass self => ReadAttr self VBox
Detail
MessageDialog
presents a dialog with an image representing the type of
message (Error, Question, etc.) alongside 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.
The easiest way to do a modal message dialog is to use dialogRun
,
though you can also pass in the DialogModal
flag, dialogRun
automatically makes the dialog modal and waits for the user to respond to
it. dialogRun
returns when any dialog button is clicked.
Class Hierarchy
|GObject
| +----Object
| +----Widget
| +----Container
| +----Bin
| +----Window
| +----Dialog
| +----MessageDialog
Types
data MessageDialog Source #
class DialogClass o => MessageDialogClass o Source #
castToMessageDialog :: GObjectClass obj => obj -> MessageDialog Source #
toMessageDialog :: MessageDialogClass o => o -> MessageDialog Source #
data MessageType Source #
data ButtonsType Source #
Specify what buttons this dialog should show.
- Prebuilt sets of buttons for the dialog. If none of these choices
are appropriate, simply use
ButtonsNone
then calldialogAddButton
.
data DialogFlags Source #
Flags used to influence dialog construction.
- Marking a dialog as model will call
widgetSetModal
on the dialog window, theDialogDestroyWithParent
will callwindowSetDestroyWithParent
on the dialog window. Note that in case the dialog is simply destroyed, no response signal is ever emitted. Finally,DialogNoSeparator
omits the separator between the action area and the dialog content which is preferable for very simple messages, i.e. those that only contain one button.
Constructors
:: GlibString string | |
=> Maybe Window | Transient parent of the dialog (or none) |
-> [DialogFlags] | |
-> MessageType | |
-> ButtonsType | |
-> string | The text of the message |
-> IO MessageDialog |
Create a new message dialog, which is a simple dialog with an icon
indicating the dialog type (error, warning, etc.) and some text the
user may want to see. When the user clicks a button a "response" signal
is emitted with response IDs from ResponseType
. See Dialog
for more
details.
messageDialogNewWithMarkup Source #
:: GlibString string | |
=> Maybe Window | Transient parent of the dialog (or none) |
-> [DialogFlags] | |
-> MessageType | |
-> ButtonsType | |
-> string | The text of the message |
-> IO MessageDialog |
Creates a new message dialog, which is a simple dialog with an icon
indicating the dialog type (error, warning, etc.) and some text which
is marked up with the Pango text markup language. When the user clicks
a button a "response" signal is emitted with response IDs from
ResponseType
. See Dialog
and PangoMarkup
for more details.
- Available since Gtk+ version 2.4
Methods
messageDialogSetMarkup Source #
:: (MessageDialogClass self, GlibString string) | |
=> self | |
-> string |
|
-> IO () |
Sets the text of the message dialog to be str
, which is marked up with
the Pango text markup language.
- Available since Gtk+ version 2.4
messageDialogSetImage Source #
:: (MessageDialogClass self, WidgetClass image) | |
=> self | |
-> image |
|
-> IO () |
Sets the dialog's image to image
.
- Available since Gtk+ version 2.10
messageDialogSetSecondaryMarkup Source #
:: (MessageDialogClass self, GlibString string) | |
=> self | |
-> string |
|
-> IO () |
messageDialogSetSecondaryText Source #
:: (MessageDialogClass self, GlibString string) | |
=> self | |
-> string |
|
-> IO () |
Attributes
messageDialogMessageType :: MessageDialogClass self => Attr self MessageType Source #
The type of message.
Default value: MessageInfo
messageDialogText :: (MessageDialogClass self, GlibString string) => Attr self (Maybe string) Source #
The primary text of the message dialog. If the dialog has a secondary text, this will appear as the title.
Default value: Nothing
- Available since Gtk+ version 2.10
messageDialogUseMarkup :: MessageDialogClass self => Attr self Bool Source #
Interpret the string messageDialogText
as markup.
Default value: False
- Available since Gtk+ version 2.10
messageDialogSecondaryText :: (MessageDialogClass self, GlibString string) => Attr self (Maybe string) Source #
The secondary text of the message dialog.
Default value: Nothing
- Available since Gtk+ version 2.10
messageDialogSecondaryUseMarkup :: MessageDialogClass self => Attr self Bool Source #
Default value: False
- Available since Gtk+ version 2.10
messageDialogImage :: (MessageDialogClass self, WidgetClass widget) => ReadWriteAttr self Widget widget Source #
The image for this dialog.
- Available since Gtk+ version 2.10
messageDialogButtons :: MessageDialogClass self => WriteAttr self ButtonsType Source #
The buttons shown in the message dialog.
Default value: ButtonsNone
messageDialogMessageArea :: MessageDialogClass self => ReadAttr self VBox Source #
The VBox
that corresponds to the message area of this dialog.
- Available since Gtk+ version 2.22