|
| Tooltip (Tooltip&& src) noexcept |
|
Tooltip& | operator= (Tooltip&& src) noexcept |
|
| ~Tooltip () noexcept override |
|
GtkTooltip* | gobj () |
| Provides access to the underlying C GObject. More...
|
|
const GtkTooltip* | gobj () const |
| Provides access to the underlying C GObject. More...
|
|
GtkTooltip* | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
|
|
void | set_markup (const Glib::ustring& markup) |
| Sets the text of the tooltip to be markup. More...
|
|
void | unset_markup () |
| Hide the label. More...
|
|
void | set_text (const Glib::ustring& text) |
| Sets the text of the tooltip to be text. More...
|
|
void | unset_text () |
| Hide the label. More...
|
|
void | set_icon (const Glib::RefPtr< Gdk::Paintable >& paintable) |
| Sets the icon of the tooltip (which is in front of the text) to be paintable. More...
|
|
void | set_icon (const Glib::RefPtr< Gio::Icon >& gicon) |
| Sets the icon of the tooltip (which is in front of the text) to be the icon indicated by gicon with the size indicated by size. More...
|
|
void | set_icon (const Glib::ustring& icon_name) |
| Sets the icon of the tooltip (which is in front of the text) to be the icon indicated by icon_name with the size indicated by size. More...
|
|
void | unset_icon () |
| Hide the image. More...
|
|
void | set_custom (Widget& custom_widget) |
| Replaces the widget packed into the tooltip with custom_widget. More...
|
|
void | unset_custom () |
| Remove the custom widget. More...
|
|
void | set_tip_area (const Gdk::Rectangle& rect) |
| Sets the area of the widget, where the contents of this tooltip apply, to be rect (in widget coordinates). More...
|
|
Add tips to your widgets.
Basic tooltips can be realized simply by using set_tooltip_text() or set_tooltip_markup() without any explicit tooltip object.
When you need a tooltip with a little more fancy contents, like adding an image, or you want the tooltip to have different contents per Gtk::TreeView row or cell, you will have to do a little more work:
- Call Gtk::Widget:set_has_tooltip(); this will make GTK+ monitor the widget for motion and related events which are needed to determine when and where to show a tooltip.
- Connect to Gtk::Widget::signal_query_tooltip(). This signal will be emitted when a tooltip is supposed to be shown. One of the arguments passed to the signal handler is a Gtk::Tooltip object. This is the object that we are about to display as a tooltip, and can be manipulated in your callback using functions like Gtk::Tooltip::set_icon(). There are functions for setting the tooltip's markup, setting an image from a named icon, or even putting in a custom widget.
- Return true from your query-tooltip handler. This causes the tooltip to be show. If you return false, it will not be shown.
- Since gtkmm 2.12: