Migrating from GtkTooltips to GtkTooltip
GTK+ 2.12 brings a completely new tooltip implementation which
allows many things that were not possible with the old
#GtkTooltips interface. The new possibilities are explained
in more detail in the section about #GtkTooltip.
A number of complications of the old API have been removed:
Tooltips can not be grouped anymore. The old tooltips
API allowed this by using multiple #GtkTooltips objects.
We believe that the timeout behaviour of the new tooltips
implementation is better and makes it unnecessary to use
grouping as a way to overcome shortcomings of the
fast-tooltips mode.
Timeouts can not be set individually anymore. Instead
there are settings #GtkSettings:gtk-tooltip-timeout,
#GtkSettings:gtk-tooltip-browse-timeout and
#GtkSettings:gtk-tooltip-browse-mode-timeout to influence
the behaviour of tooltips globally.
Here is an example of setting a tooltip on a widget with the old API:
GtkTooltips *tooltips = gtk_tooltips_new ();
gtk_tooltips_set_tip (tooltips, widget, "Some tips", NULL);
Using the new tooltips API, it is no longer necessary to create
an object:
gtk_widget_set_tooltip_text (widget, "Some tips");
Similarly, setting a tooltip on a #GtkToolItem gets
simplified from
gtk_tool_item_set_tooltip (toolitem, toolbar->tooltips, "tool tip", NULL);
to
gtk_tool_item_set_tooltip_text (toolitem, text);