|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
<html>
|
|
Packit Service |
fb6fa5 |
<head>
|
|
Packit Service |
fb6fa5 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
Packit Service |
fb6fa5 |
<title>Migrating from GtkTooltips to GtkTooltip: GTK+ 2 Reference Manual</title>
|
|
Packit Service |
fb6fa5 |
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
|
Packit Service |
fb6fa5 |
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
|
|
Packit Service |
fb6fa5 |
<link rel="up" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
|
|
Packit Service |
fb6fa5 |
<link rel="prev" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
|
|
Packit Service |
fb6fa5 |
<link rel="next" href="gtk-migrating-entry-icons.html" title="Migrating from SexyIconEntry to GtkEntry">
|
|
Packit Service |
fb6fa5 |
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
|
|
Packit Service |
fb6fa5 |
<link rel="stylesheet" href="style.css" type="text/css">
|
|
Packit Service |
fb6fa5 |
</head>
|
|
Packit Service |
fb6fa5 |
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
Migrating from GtkTooltips to GtkTooltip
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
GTK+ 2.12 brings a completely new tooltip implementation which
|
|
Packit Service |
fb6fa5 |
allows many things that were not possible with the old
|
|
Packit Service |
fb6fa5 |
GtkTooltips interface. The new possibilities are explained
|
|
Packit Service |
fb6fa5 |
in more detail in the section about GtkTooltip.
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
A number of complications of the old API have been removed:
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
Tooltips can not be grouped anymore. The old tooltips
|
|
Packit Service |
fb6fa5 |
API allowed this by using multiple GtkTooltips objects.
|
|
Packit Service |
fb6fa5 |
We believe that the timeout behaviour of the new tooltips
|
|
Packit Service |
fb6fa5 |
implementation is better and makes it unnecessary to use
|
|
Packit Service |
fb6fa5 |
grouping as a way to overcome shortcomings of the
|
|
Packit Service |
fb6fa5 |
fast-tooltips mode.
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
Timeouts can not be set individually anymore. Instead
|
|
Packit Service |
fb6fa5 |
there are settings “gtk-tooltip-timeout”,
|
|
Packit Service |
fb6fa5 |
“gtk-tooltip-browse-timeout” and
|
|
Packit Service |
fb6fa5 |
“gtk-tooltip-browse-mode-timeout” to influence
|
|
Packit Service |
fb6fa5 |
the behaviour of tooltips globally.
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
Here is an example of setting a tooltip on a widget with the old API:
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
1
|
|
Packit Service |
fb6fa5 |
2
|
|
Packit Service |
fb6fa5 |
GtkTooltips *tooltips = gtk_tooltips_new ();
|
|
Packit Service |
fb6fa5 |
gtk_tooltips_set_tip (tooltips, widget, "Some tips", NULL);
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
Using the new tooltips API, it is no longer necessary to create
|
|
Packit Service |
fb6fa5 |
an object:
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
1
|
|
Packit Service |
fb6fa5 |
gtk_widget_set_tooltip_text (widget, "Some tips");
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
Similarly, setting a tooltip on a GtkToolItem gets
|
|
Packit Service |
fb6fa5 |
simplified from
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
1
|
|
Packit Service |
fb6fa5 |
gtk_tool_item_set_tooltip (toolitem, toolbar->tooltips, "tool tip", NULL);
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
to
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
1
|
|
Packit Service |
fb6fa5 |
gtk_tool_item_set_tooltip_text (toolitem, text);
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
|
|
Packit Service |
fb6fa5 |
Generated by GTK-Doc V1.26.1
|
|
Packit Service |
fb6fa5 |
</body>
|
|
Packit Service |
fb6fa5 |
</html>
|