Maeomm Reference Documentation: hildon-libsmm |
They show a small information banner in the top right corner of the application view for a few seconds and then disappear automatically. They are used for all kinds of notifications, such as "File Saved", "Unable to make connection" or "Choose one option only".
There are multiple static methods to choose, depending on the information you want to show. The banner can show the user plain text, a custom icon, or a progress bar.
Public Member Functions | |
const HildonBanner* | gobj () const |
Provides access to the underlying C GtkObject. | |
HildonBanner* | gobj () |
Provides access to the underlying C GtkObject. | |
void | set_fraction (double fraction) |
The fraction is the completion of progressbar, the scale is from 0.0 to 1.0. | |
void | set_markup (const Glib::ustring& markup) |
Sets the text with markup that is displayed in the banner. | |
void | set_text (const Glib::ustring& text) |
Sets the text that is displayed in the banner. | |
virtual | ~Banner () |
Static Public Member Functions | |
static Banner* | show_animation (Gtk::Widget& widget, const Glib::ustring& text) |
Shows an animated progress notification. | |
static Banner* | show_animation (Gtk::Widget& widget, const Glib::ustring& animation_name, const Glib::ustring& text) |
Shows an animated progress notification. | |
static void | show_information (Gtk::Widget& widget, const Glib::ustring& text) |
This function creates and displays an information banner that automatically goes away after a certain time period. | |
static void | show_information (Gtk::Widget& widget, const Glib::ustring& icon_name, const Glib::ustring& text) |
This function creates and displays an information banner that automatically goes away after certain time period. | |
static void | show_information_with_markup (Gtk::Widget& widget, const Glib::ustring& markup) |
This function creates and displays an information banner that automatically goes away after a certain time period. | |
static void | show_information_with_markup (Gtk::Widget& widget, const Glib::ustring& icon_name, const Glib::ustring& markup) |
This function creates and displays an information banner that automatically goes away after certain time period. | |
static Banner* | show_progress (Gtk::Widget& widget, const Glib::ustring& text) |
Shows progress notification. | |
static Banner* | show_progress (Gtk::Widget& widget, Gtk::ProgressBar& bar, const Glib::ustring& text) |
Shows progress notification. | |
Protected Member Functions | |
Banner () | |
Related Functions | |
(Note that these are not member functions.) | |
Hildon::Banner* | wrap (HildonBanner* object, bool take_copy=false) |
|
|
|
|
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Window. |
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Window. |
|
The fraction is the completion of progressbar, the scale is from 0.0 to 1.0. Sets the amount of fraction the progressbar has. Since: 0.12.2
|
|
Sets the text with markup that is displayed in the banner. Since: 0.12.8
|
|
Sets the text that is displayed in the banner. Since: 0.12.2
|
|
Shows an animated progress notification. It's recommended not to try to show more than one progress notification at a time, since they will appear on top of each other. You can use progress notifications with timed banners. In this case the banners are located so that you can somehow see both. Please note that banners are destroyed automatically once the window they are attached to is closed. The pointer that you receive with this function does not contain additional references, so it can become invalid without warning (this is true for all toplevel windows in gtk).
|
|
Shows an animated progress notification. It's recommended not to try to show more than one progress notification at a time, since they will appear on top of each other. You can use progress notifications with timed banners. In this case the banners are located so that you can somehow see both. Please note that banners are destroyed automatically once the window they are attached to is closed. The pointer that you receive with this function do not contain additional references, so it can become invalid without warning (this is true for all toplevel windows in gtk). To make sure that the banner do not disapear automatically, you can separately ref the return value (this doesn't prevent the banner from disappearing, but the object it just not finalized). In this case you have to delete it manually.
|
|
This function creates and displays an information banner that automatically goes away after a certain time period. For each window in your application there can only be one timed banner, so if you spawn a new banner before the earlier one has timed out, the previous one will be replaced.
|
|
This function creates and displays an information banner that automatically goes away after certain time period. For each window in your application there can only be one timed banner, so if you spawn a new banner before the earlier one has timed out, the previous one will be replaced. Since: 0.12.2
|
|
This function creates and displays an information banner that automatically goes away after a certain time period. For each window in your application there can only be one timed banner, so if you spawn a new banner before the earlier one has timed out, the previous one will be replaced.
|
|
This function creates and displays an information banner that automatically goes away after certain time period. For each window in your application there can only be one timed banner, so if you spawn a new banner before the earlier one has timed out, the previous one will be replaced. Since: 0.12.8
|
|
Shows progress notification. See show_animation() for more information.
|
|
Shows progress notification. See show_animation for more information.
|
|
|