Gtk::MessageDialog Class Reference
[Dialogs]

Convenient message window. More...

Inherits Gtk::Dialog.

Collaboration diagram for Gtk::MessageDialog:

[legend]

List of all members.

Public Member Functions
virtual	~MessageDialog ()
GtkMessageDialog*	gobj ()
	Provides access to the underlying C GtkObject.
const GtkMessageDialog*	gobj () const
	Provides access to the underlying C GtkObject.
	MessageDialog (const Glib::ustring& message, bool use_markup=false, MessageType type=MESSAGE_INFO, ButtonsType buttons=BUTTONS_OK, bool modal=false)
	MessageDialog (Gtk::Window& parent, const Glib::ustring& message, bool use_markup=false, MessageType type=MESSAGE_INFO, ButtonsType buttons=BUTTONS_OK, bool modal=false)
void	set_image (Widget& image)
	Sets the dialog's image to image.
Widget*	get_image ()
	Gets the dialog's image.
const Widget*	get_image () const
	Gets the dialog's image.
void	set_markup (const Glib::ustring& str)
	Sets the text of the message dialog to be str, which is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
void	set_message (const Glib::ustring& message, bool use_markup=false)
	Sets the primary text of the message dialog.
void	set_secondary_text (const Glib::ustring& text, bool use_markup=false)
	Sets the secondary text of the message dialog.
Glib::PropertyProxy< MessageType >	property_message_type ()
	The type of message.
Glib::PropertyProxy_ReadOnly < MessageType >	property_message_type () const
	The type of message.
Glib::PropertyProxy < Glib::ustring >	property_text ()
	The primary text of the message dialog.
Glib::PropertyProxy_ReadOnly < Glib::ustring >	property_text () const
	The primary text of the message dialog.
Glib::PropertyProxy< bool >	property_use_markup ()
	The primary text of the title includes Pango markup.
Glib::PropertyProxy_ReadOnly < bool >	property_use_markup () const
	The primary text of the title includes Pango markup.
Glib::PropertyProxy < Glib::ustring >	property_secondary_text ()
	The secondary text of the message dialog.
Glib::PropertyProxy_ReadOnly < Glib::ustring >	property_secondary_text () const
	The secondary text of the message dialog.
Glib::PropertyProxy< bool >	property_secondary_use_markup ()
	The secondary text includes Pango markup.
Glib::PropertyProxy_ReadOnly < bool >	property_secondary_use_markup () const
	The secondary text includes Pango markup.
Glib::PropertyProxy< Widget* >	property_image ()
	The image.
Glib::PropertyProxy_ReadOnly < Widget* >	property_image () const
	The image.
Related Functions
(Note that these are not member functions.)
Gtk::MessageDialog*	wrap (GtkMessageDialog* object, bool take_copy=false)
	A Glib::wrap() method for this object.

---

Detailed Description

Convenient message window.

Gtk::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 Gtk::MessageDialog from Gtk::Dialog without too much effort, but Gtk::MessageDialog saves typing.

A MessageDialog looks like this:

---

Constructor & Destructor Documentation

virtual Gtk::MessageDialog::~MessageDialog

(

)

[virtual]

Gtk::MessageDialog::MessageDialog	(	const Glib::ustring &	message,
		bool	use_markup = false,
		MessageType	type = MESSAGE_INFO,
		ButtonsType	buttons = BUTTONS_OK,
		bool	modal = false
	)			[explicit]

Gtk::MessageDialog::MessageDialog	(	Gtk::Window&	parent,
		const Glib::ustring &	message,
		bool	use_markup = false,
		MessageType	type = MESSAGE_INFO,
		ButtonsType	buttons = BUTTONS_OK,
		bool	modal = false
	)

---

Member Function Documentation

const Widget* Gtk::MessageDialog::get_image

(

)

const

Gets the dialog's image.

Since gtkmm 2.14:

Returns:

The dialog's image.

Widget* Gtk::MessageDialog::get_image

(

)

Gets the dialog's image.

Since gtkmm 2.14:

Returns:

The dialog's image.

const GtkMessageDialog* Gtk::MessageDialog::gobj

(

)

const [inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::Dialog.

GtkMessageDialog* Gtk::MessageDialog::gobj

(

)

[inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::Dialog.

Glib::PropertyProxy_ReadOnly<Widget*> Gtk::MessageDialog::property_image

(

)

const

The image.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy<Widget*> Gtk::MessageDialog::property_image

(

)

The image.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy_ReadOnly<MessageType> Gtk::MessageDialog::property_message_type

(

)

const

The type of message.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy<MessageType> Gtk::MessageDialog::property_message_type

(

)

The type of message.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy_ReadOnly<Glib::ustring> Gtk::MessageDialog::property_secondary_text

(

)

const

The secondary text of the message dialog.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy<Glib::ustring> Gtk::MessageDialog::property_secondary_text

(

)

The secondary text of the message dialog.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy_ReadOnly<bool> Gtk::MessageDialog::property_secondary_use_markup

(

)

const

The secondary text includes Pango markup.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy<bool> Gtk::MessageDialog::property_secondary_use_markup

(

)

The secondary text includes Pango markup.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy_ReadOnly<Glib::ustring> Gtk::MessageDialog::property_text

(

)

const

The primary text of the message dialog.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy<Glib::ustring> Gtk::MessageDialog::property_text

(

)

The primary text of the message dialog.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy_ReadOnly<bool> Gtk::MessageDialog::property_use_markup

(

)

const

The primary text of the title includes Pango markup.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

Glib::PropertyProxy<bool> Gtk::MessageDialog::property_use_markup

(

)

The primary text of the title includes Pango markup.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:

A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.

void Gtk::MessageDialog::set_image

(

Widget&

image

)

Sets the dialog's image to image.

Since gtkmm 2.10:

Parameters:

image

The image.

void Gtk::MessageDialog::set_markup

(

const Glib::ustring &

str

)

Sets the text of the message dialog to be str, which is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.

Since gtkmm 2.4:

Deprecated:

Use set_message(string, true).

Parameters:

str

Markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>).

void Gtk::MessageDialog::set_message	(	const Glib::ustring &	message,
		bool	use_markup = false
	)

Sets the primary text of the message dialog.

Parameters:

	text	The message.
	use_markup	Whether message contains pango markup.

void Gtk::MessageDialog::set_secondary_text	(	const Glib::ustring &	text,
		bool	use_markup = false
	)

Sets the secondary text of the message dialog.

Note that setting a secondary text makes the primary text become bold, unless you have provided explicit markup.

Since gtkmm 2.6:

Parameters:

	text	The message.
	use_markup	Whether message contains pango markup.

---

Friends And Related Function Documentation

Gtk::MessageDialog* wrap	(	GtkMessageDialog *	object,
		bool	take_copy = false
	)			[related]

A Glib::wrap() method for this object.

Parameters:

	object	The C instance.
	take_copy	False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns:

A C++ instance that wraps this C instance.

---

The documentation for this class was generated from the following file:

• gtkmm/messagedialog.h