gtk-0.14.6: Binding to the Gtk+ graphical user interface library.

Maintainergtk2hs-users@lists.sourceforge.net
Stabilityprovisional
Portabilityportable (depends on GHC)
Safe HaskellNone
LanguageHaskell98

Graphics.UI.Gtk.Windows.MessageDialog

Contents

Description

A convenient message window

Synopsis

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 #

Instances

class DialogClass o => MessageDialogClass o Source #

Instances

castToMessageDialog :: GObjectClass obj => obj -> MessageDialog Source #

gTypeMessageDialog :: GType Source #

toMessageDialog :: MessageDialogClass o => o -> MessageDialog Source #

data MessageType Source #

Constructors

MessageInfo 
MessageWarning 
MessageQuestion 
MessageError 
MessageOther 

Instances

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 call dialogAddButton.

Constructors

ButtonsNone 
ButtonsOk 
ButtonsClose 
ButtonsCancel 
ButtonsYesNo 
ButtonsOkCancel 

Instances

data DialogFlags Source #

Flags used to influence dialog construction.

  • Marking a dialog as model will call widgetSetModal on the dialog window, the DialogDestroyWithParent will call windowSetDestroyWithParent 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

DialogModal 
DialogDestroyWithParent 
DialogNoSeparator 

Instances

Constructors

messageDialogNew Source #

Arguments

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

Arguments

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

Arguments

:: (MessageDialogClass self, GlibString string) 
=> self 
-> string

str - markup string (see Pango markup format)

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

Arguments

:: (MessageDialogClass self, WidgetClass image) 
=> self 
-> image

image - the image

-> IO () 

Sets the dialog's image to image.

  • Available since Gtk+ version 2.10

messageDialogSetSecondaryMarkup Source #

Arguments

:: (MessageDialogClass self, GlibString string) 
=> self 
-> string

str - markup string (see Pango markup format)

-> IO () 

messageDialogSetSecondaryText Source #

Arguments

:: (MessageDialogClass self, GlibString string) 
=> self 
-> string

str - text to be shown as second line

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