| libgdamm Reference Documentation |

Public Types | |
| typedef sigc::slot< void, const Glib::ustring& > | SlotInvokeAction |
| For instance, void on_invoke(const Glib::ustring& action);. | |
Public Member Functions | |
| void | add_action (const Glib::ustring& action, const Glib::ustring& label, const SlotInvokeAction& slot) |
| Add an action to the notification. | |
| void | attach_to_status_icon (const Glib::RefPtr<Gtk::StatusIcon>& status_icon) |
| Attaches the notification to a Gtk::StatusIcon. | |
| void | attach_to_widget (Gtk::Widget& attach) |
| Attaches the notification to a widget. | |
| void | clear_actions () |
| Clears all actions from the notification. | |
| void | clear_hints () |
| Clears all hints from the notification. | |
| void | close () |
| Tells the notification server to hide the notification on the screen. | |
| const NotifyNotification* | gobj () const |
| Provides access to the underlying C GObject. | |
| NotifyNotification* | gobj () |
| Provides access to the underlying C GObject. | |
| NotifyNotification* | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
| Notification (const Glib::ustring& summary, const Glib::ustring& body, const Glib::ustring& icon_name, const Glib::RefPtr<Gtk::StatusIcon>& status_icon) | |
| A constructor for Notification. | |
| Notification (const Glib::ustring& summary, const Glib::ustring& body, const Glib::ustring& icon_name, Gtk::Widget& attach_widget) | |
| A constructor for Notification. | |
| Notification (const Glib::ustring& summary, const Glib::ustring& body, const Glib::ustring& icon_name) | |
| A constructor for Notification. | |
| Notification (const Glib::ustring& summary, const Glib::ustring& body) | |
| A constructor for Notification. | |
| Glib::PropertyProxy_ReadOnly <Gtk::Widget> | property_attach_widget () const |
| The widget to attach the notification to. | |
| Glib::PropertyProxy<Gtk::Widget> | property_attach_widget () |
| The widget to attach the notification to. | |
| Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_body () const |
| The message body text. | |
| Glib::PropertyProxy <Glib::ustring> | property_body () |
| The message body text. | |
| Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_icon_name () const |
| The icon filename or icon theme-compliant name. | |
| Glib::PropertyProxy <Glib::ustring> | property_icon_name () |
| The icon filename or icon theme-compliant name. | |
| Glib::PropertyProxy_ReadOnly < Glib::RefPtr <Gtk::StatusIcon >> | property_status_icon () const |
| The status icon to attach the notification to. | |
| Glib::PropertyProxy < Glib::RefPtr <Gtk::StatusIcon >> | property_status_icon () |
| The status icon to attach the notification to. | |
| Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_summary () const |
| The summary text. | |
| Glib::PropertyProxy <Glib::ustring> | property_summary () |
| The summary text. | |
| void | set_category (const Glib::ustring& category) |
| Sets the category of this notification. | |
| void | set_geometry_hints (const Glib::RefPtr<Gdk::Screen>& screen, int x, int y) |
| Sets the geometry hints on the notification. | |
| void | set_hint (const Glib::ustring& key, const Glib::ArrayHandle<guchar>& values) |
| Set byte array hint. | |
| void | set_hint (const Glib::ustring& key, guchar value) |
| Sets a hint with a byte value. | |
| void | set_hint (const Glib::ustring& key, const Glib::ustring& value) |
| Sets a hint with a string value. | |
| void | set_hint (const Glib::ustring& key, double value) |
| Sets a hint with a double value. | |
| void | set_hint (const Glib::ustring& key, int value) |
| Sets a hint with a 32-bit integer value. | |
| void | set_icon_from_pixbuf (const Glib::RefPtr<Gdk::Pixbuf>& icon) |
| Sets the icon in the notification from a Gdk::Pixbuf. | |
| void | set_timeout (int timeout) |
| Sets the timeout of the notification. | |
| void | set_urgency (Urgency urgency) |
| Sets the urgency level of this notification. | |
| bool | show () |
| Tells the notification server to display the notification on the screen. | |
| Glib::SignalProxy0<void> | signal_closed () |
| bool | update (const Glib::ustring& summary, const Glib::ustring& body, const Glib::ustring& icon) |
| Updates the notification text and icon. | |
| virtual | ~Notification () |
Protected Member Functions | |
| virtual void | on_closed () |
Related Functions | |
| (Note that these are not member functions.) | |
| Glib::RefPtr <Notify::Notification> | wrap (NotifyNotification* object, bool take_copy=false) |
| A Glib::wrap() method for this object. | |
| typedef sigc::slot<void, const Glib::ustring& > Notify::Notification::SlotInvokeAction |
For instance, void on_invoke(const Glib::ustring& action);.
| virtual Notify::Notification::~Notification | ( | ) | [virtual] |
| Notify::Notification::Notification | ( | const Glib::ustring & | summary, | |
| const Glib::ustring & | body | |||
| ) |
A constructor for Notification.
| summary | summary of the notification | |
| body | body text of the notification |
| Notify::Notification::Notification | ( | const Glib::ustring & | summary, | |
| const Glib::ustring & | body, | |||
| const Glib::ustring & | icon_name | |||
| ) |
A constructor for Notification.
| summary | summary of the notification | |
| body | body text of the notification | |
| icon_name | name of the icon for the notification, can be a stock id |
| Notify::Notification::Notification | ( | const Glib::ustring & | summary, | |
| const Glib::ustring & | body, | |||
| const Glib::ustring & | icon_name, | |||
| Gtk::Widget & | attach_widget | |||
| ) | [explicit] |
A constructor for Notification.
| summary | summary of the notification | |
| body | body text of the notification | |
| icon_name | name of the icon for the notification, can be a stock id | |
| attach_widget | widget the notification is attach to |
| Notify::Notification::Notification | ( | const Glib::ustring & | summary, | |
| const Glib::ustring & | body, | |||
| const Glib::ustring & | icon_name, | |||
| const Glib::RefPtr< Gtk::StatusIcon > & | status_icon | |||
| ) | [explicit] |
A constructor for Notification.
| summary | summary of the notification | |
| body | body text of the notification | |
| icon_name | name of the icon for the notification, can be a stock id | |
| status_icon | Gtk::StatusIcon the notification is attached to |
| void Notify::Notification::add_action | ( | const Glib::ustring & | action, | |
| const Glib::ustring & | label, | |||
| const SlotInvokeAction& | slot | |||
| ) |
Add an action to the notification.
| action | The action id | |
| label | The action label | |
| slot | A function or method to call when the action is invoked |
| void Notify::Notification::attach_to_status_icon | ( | const Glib::RefPtr< Gtk::StatusIcon > & | status_icon | ) |
Attaches the notification to a Gtk::StatusIcon.
This will set hints on the notification requesting that the notification point to the status icon's location. If status_icon is 0, the status icon will be unset.
Since: 0.4.1
| status_icon | The Gtk::StatusIcon to attach to, or 0. |
| void Notify::Notification::attach_to_widget | ( | Gtk::Widget & | attach | ) |
Attaches the notification to a widget.
This will set hints on the notification requesting that the notification point to the widget's location. If attach is 0, the widget will be unset.
| attach | The widget to attach to, or 0. |
| void Notify::Notification::clear_actions | ( | ) |
Clears all actions from the notification.
| void Notify::Notification::clear_hints | ( | ) |
Clears all hints from the notification.
| void Notify::Notification::close | ( | ) |
Tells the notification server to hide the notification on the screen.
true if successful. On error, this will return false and set error. | const NotifyNotification* Notify::Notification::gobj | ( | ) | const [inline] |
| NotifyNotification* Notify::Notification::gobj | ( | ) | [inline] |
| NotifyNotification* Notify::Notification::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
| virtual void Notify::Notification::on_closed | ( | ) | [protected, virtual] |
| Glib::PropertyProxy_ReadOnly<Gtk::Widget> Notify::Notification::property_attach_widget | ( | ) | const |
The widget to attach the notification to.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<Gtk::Widget> Notify::Notification::property_attach_widget | ( | ) |
The widget to attach the notification to.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<Glib::ustring> Notify::Notification::property_body | ( | ) | const |
The message body text.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<Glib::ustring> Notify::Notification::property_body | ( | ) |
The message body text.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<Glib::ustring> Notify::Notification::property_icon_name | ( | ) | const |
The icon filename or icon theme-compliant name.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<Glib::ustring> Notify::Notification::property_icon_name | ( | ) |
The icon filename or icon theme-compliant name.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gtk::StatusIcon> > Notify::Notification::property_status_icon | ( | ) | const |
The status icon to attach the notification to.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy< Glib::RefPtr<Gtk::StatusIcon> > Notify::Notification::property_status_icon | ( | ) |
The status icon to attach the notification to.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<Glib::ustring> Notify::Notification::property_summary | ( | ) | const |
The summary text.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<Glib::ustring> Notify::Notification::property_summary | ( | ) |
The summary text.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| void Notify::Notification::set_category | ( | const Glib::ustring & | category | ) |
Sets the category of this notification.
This can be used by the notification server to filter or display the data in a certain way.
| category | The category. |
| void Notify::Notification::set_geometry_hints | ( | const Glib::RefPtr< Gdk::Screen > & | screen, | |
| int | x, | |||
| int | y | |||
| ) |
Sets the geometry hints on the notification.
This sets the screen the notification should appear on and the X, Y coordinates it should point to, if the particular notification supports X, Y hints.
Since: 0.4.1
| screen | The Gdk::Screen the notification should appear on. | |
| x | The X coordinate to point to. | |
| y | The Y coordinate to point to. |
| void Notify::Notification::set_hint | ( | const Glib::ustring & | key, | |
| const Glib::ArrayHandle< guchar > & | values | |||
| ) |
Set byte array hint.
| key | The hint. | |
| values | The hint's value. |
| void Notify::Notification::set_hint | ( | const Glib::ustring & | key, | |
| guchar | value | |||
| ) |
Sets a hint with a byte value.
| key | The hint. | |
| value | The hint's value. |
| void Notify::Notification::set_hint | ( | const Glib::ustring & | key, | |
| const Glib::ustring & | value | |||
| ) |
Sets a hint with a string value.
| key | The hint. | |
| value | The hint's value. |
| void Notify::Notification::set_hint | ( | const Glib::ustring & | key, | |
| double | value | |||
| ) |
Sets a hint with a double value.
| key | The hint. | |
| value | The hint's value. |
| void Notify::Notification::set_hint | ( | const Glib::ustring & | key, | |
| int | value | |||
| ) |
Sets a hint with a 32-bit integer value.
| key | The hint. | |
| value | The hint's value. |
| void Notify::Notification::set_icon_from_pixbuf | ( | const Glib::RefPtr< Gdk::Pixbuf > & | icon | ) |
Sets the icon in the notification from a Gdk::Pixbuf.
This will only work when libnotify is compiled against D-BUS 0.60 or higher.
| icon | The icon. |
| void Notify::Notification::set_timeout | ( | int | timeout | ) |
Sets the timeout of the notification.
To set the default time, pass Notify::EXPIRES_DEFAULT as timeout. To set the notification to never expire, pass Notify::EXPIRES_NEVER.
| timeout | The timeout in milliseconds. |
| void Notify::Notification::set_urgency | ( | Urgency | urgency | ) |
Sets the urgency level of this notification.
See: Notify::Urgency
| urgency | The urgency level. |
| bool Notify::Notification::show | ( | ) |
Tells the notification server to display the notification on the screen.
true if successful. On error, this will return false and set error. | Glib::SignalProxy0< void > Notify::Notification::signal_closed | ( | ) |
void on_my_closed() | bool Notify::Notification::update | ( | const Glib::ustring & | summary, | |
| const Glib::ustring & | body, | |||
| const Glib::ustring & | icon | |||
| ) |
Updates the notification text and icon.
This won't send the update out and display it on the screen. For that, you will need to call show().
| summary | The new required summary text. | |
| body | The optional body text. | |
| icon | The optional icon theme icon name or filename. |
true, unless an invalid parameter was passed.
| Glib::RefPtr<Notify::Notification> wrap | ( | NotifyNotification * | object, | |
| bool | take_copy = false | |||
| ) | [related] |
A Glib::wrap() method for this object.
| 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. |