Gtk::MessageDialog Class Reference
[Dialogs]

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:

Public Member Functions | |
const Widget* | get_image () const |
Gets the dialog's image. | |
Widget* | get_image () |
Gets the dialog's image. | |
const GtkMessageDialog* | gobj () const |
Provides access to the underlying C GtkObject. | |
GtkMessageDialog* | gobj () |
Provides access to the underlying C GtkObject. | |
MessageDialog (Gtk::Window& parent, const Glib::ustring& message, bool use_markup=false, MessageType type=MESSAGE_INFO, ButtonsType buttons=BUTTONS_OK, bool modal=false) | |
MessageDialog (const Glib::ustring& message, bool use_markup=false, MessageType type=MESSAGE_INFO, ButtonsType buttons=BUTTONS_OK, bool modal=false) | |
Glib::PropertyProxy_ReadOnly <Widget*> | property_image () const |
The image. | |
Glib::PropertyProxy<Widget*> | property_image () |
The image. | |
Glib::PropertyProxy_ReadOnly <MessageType> | property_message_type () const |
The type of message. | |
Glib::PropertyProxy<MessageType> | property_message_type () |
The type of message. | |
Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_secondary_text () const |
The secondary text of the message dialog. | |
Glib::PropertyProxy <Glib::ustring> | property_secondary_text () |
The secondary text of the message dialog. | |
Glib::PropertyProxy_ReadOnly <bool> | property_secondary_use_markup () const |
The secondary text includes Pango markup. | |
Glib::PropertyProxy<bool> | property_secondary_use_markup () |
The secondary text includes Pango markup. | |
Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_text () const |
The primary text of the message dialog. | |
Glib::PropertyProxy <Glib::ustring> | property_text () |
The primary text of the message dialog. | |
Glib::PropertyProxy_ReadOnly <bool> | property_use_markup () const |
The primary text of the title includes Pango markup. | |
Glib::PropertyProxy<bool> | property_use_markup () |
The primary text of the title includes Pango markup. | |
void | set_image (Widget& image) |
Sets the dialog's image to 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. | |
virtual | ~MessageDialog () |
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. |
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 |
Widget* Gtk::MessageDialog::get_image | ( | ) |
const GtkMessageDialog* Gtk::MessageDialog::gobj | ( | ) | const [inline] |
GtkMessageDialog* Gtk::MessageDialog::gobj | ( | ) | [inline] |
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 | ) |
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>.
- 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.
- 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: