|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GtkTooltips</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="MiscObjects.html" title="Miscellaneous">
<link rel="prev" href="GtkSizeGroup.html" title="GtkSizeGroup">
<link rel="next" href="GtkViewport.html" title="GtkViewport">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkSizeGroup.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="MiscObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkViewport.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3615323" class="shortcut">Top</a>
 | 
<a href="#id3615612" class="shortcut">Description</a>
 | 
<a href="#id3615573" class="shortcut">Object Hierarchy</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkTooltips"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3615323"></a><span class="refentrytitle">GtkTooltips</span>
</h2>
<p>GtkTooltips — Add tips to your widgets</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gtk/gtk.h>
<a href="GtkTooltips.html#GtkTooltips-struct">GtkTooltips</a>;
<a href="GtkTooltips.html#GtkTooltipsData">GtkTooltipsData</a>;
<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a>* <a href="GtkTooltips.html#gtk-tooltips-new">gtk_tooltips_new</a> (void);
void <a href="GtkTooltips.html#gtk-tooltips-enable">gtk_tooltips_enable</a> (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips);
void <a href="GtkTooltips.html#gtk-tooltips-disable">gtk_tooltips_disable</a> (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips);
void <a href="GtkTooltips.html#gtk-tooltips-set-delay">gtk_tooltips_set_delay</a> (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> delay);
void <a href="GtkTooltips.html#gtk-tooltips-set-tip">gtk_tooltips_set_tip</a> (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *tip_text,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *tip_private);
<a href="GtkTooltips.html#GtkTooltipsData">GtkTooltipsData</a>* <a href="GtkTooltips.html#gtk-tooltips-data-get">gtk_tooltips_data_get</a> (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
void <a href="GtkTooltips.html#gtk-tooltips-force-window">gtk_tooltips_force_window</a> (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GtkTooltips.html#gtk-tooltips-get-info-from-tip-window">gtk_tooltips_get_info_from_tip_window</a>
(<a href="GtkWindow.html" title="GtkWindow">GtkWindow</a> *tip_window,
<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> **tooltips,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> **current_widget);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3615573"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
+----GtkTooltips
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3615612"></a><h2>Description</h2>
<p>
Tooltips are the messages that appear next to a widget when the mouse pointer is held over it for a short amount of time. They are especially helpful for adding more verbose descriptions of things such as buttons in a toolbar.
</p>
<p>
An individual tooltip belongs to a group of tooltips. A group is created with a call to <a href="GtkTooltips.html#gtk-tooltips-new"><code class="function">gtk_tooltips_new()</code></a>. Every tooltip in the group can then be turned off with a call to <a href="GtkTooltips.html#gtk-tooltips-disable"><code class="function">gtk_tooltips_disable()</code></a> and enabled with <a href="GtkTooltips.html#gtk-tooltips-enable"><code class="function">gtk_tooltips_enable()</code></a>.
</p>
<p>
The length of time the user must keep the mouse over a widget before the tip is shown, can be altered with <a href="GtkTooltips.html#gtk-tooltips-set-delay"><code class="function">gtk_tooltips_set_delay()</code></a>. This is set on a 'per group of tooltips' basis.
</p>
<p>
To assign a tip to a particular <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, <a href="GtkTooltips.html#gtk-tooltips-set-tip"><code class="function">gtk_tooltips_set_tip()</code></a> is used.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
Tooltips can only be set on widgets which have their own X window and
receive enter and leave events.
To check if a widget has its own window use <a href="GtkWidget.html#GTK-WIDGET-NO-WINDOW:CAPS"><code class="function">GTK_WIDGET_NO_WINDOW()</code></a>.
To add a tooltip to a widget that doesn't have its own window, place the
widget inside a <a href="GtkEventBox.html" title="GtkEventBox"><span class="type">GtkEventBox</span></a> and add a tooltip to that instead.
</p>
</div>
<p>
The default appearance of all tooltips in a program is determined by the current GTK+ theme that the user has selected.
</p>
<p>
Information about the tooltip (if any) associated with an arbitrary widget can be retrieved using <a href="GtkTooltips.html#gtk-tooltips-data-get"><code class="function">gtk_tooltips_data_get()</code></a>.
</p>
<p>
</p>
<div class="example">
<a name="id3615762"></a><p class="title"><b>Example 2. Adding tooltips to buttons.</b></p>
<pre class="programlisting">
GtkWidget *load_button, *save_button, *hbox;
GtkTooltips *button_bar_tips;
button_bar_tips = gtk_tooltips_new ();
/* Create the buttons and pack them into a GtkHBox */
hbox = gtk_hbox_new (TRUE, 2);
load_button = gtk_button_new_with_label ("Load a file");
gtk_box_pack_start (GTK_BOX (hbox), load_button, TRUE, TRUE, 2);
gtk_widget_show (load_button);
save_button = gtk_button_new_with_label ("Save a file");
gtk_box_pack_start (GTK_BOX (hbox), save_button, TRUE, TRUE, 2);
gtk_widget_show (save_button);
gtk_widget_show (hbox);
/* Add the tips */
gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), load_button,
"Load a new document into this window",
"Requests the filename of a document.
This will then be loaded into the current
window, replacing the contents of whatever
is already loaded.");
gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), save_button,
"Saves the current document to a file",
"If you have saved the document previously,
then the new version will be saved over the
old one. Otherwise, you will be prompted for
a filename.");
</pre>
</div>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3615798"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3615808"></a><h3>
<a name="GtkTooltips-struct"></a>GtkTooltips</h3>
<a class="indexterm" name="id3615821"></a><pre class="programlisting">typedef struct _GtkTooltips GtkTooltips;</pre>
<p>Holds information about a group of tooltips. Fields should be changed using the functions provided, rather than directly accessing the struct's members.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3615839"></a><h3>
<a name="GtkTooltipsData"></a>GtkTooltipsData</h3>
<a class="indexterm" name="id3615852"></a><pre class="programlisting">typedef struct {
GtkTooltips *tooltips;
GtkWidget *widget;
gchar *tip_text;
gchar *tip_private;
} GtkTooltipsData;
</pre>
<p>
<em class="structfield"><code>tooltips</code></em> is the <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> group that this tooltip belongs to. <em class="structfield"><code>widget</code></em> is the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that this tooltip data is associated with. <em class="structfield"><code>tip_text</code></em> is a string containing the tooltip message itself.</p>
<p>
<em class="structfield"><code>tip_private</code></em> is a string that is not shown as the default tooltip. Instead, this message may be more informative and go towards forming a context-sensitive help system for your application. (FIXME: how to actually "switch on" private tips?)
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3615908"></a><h3>
<a name="gtk-tooltips-new"></a>gtk_tooltips_new ()</h3>
<a class="indexterm" name="id3615921"></a><pre class="programlisting"><a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a>* gtk_tooltips_new (void);</pre>
<p>
Creates an empty group of tooltips. This function initialises a <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> structure. Without at least one such structure, you can not add tips to your application.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a new <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> group for you to use.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3615976"></a><h3>
<a name="gtk-tooltips-enable"></a>gtk_tooltips_enable ()</h3>
<a class="indexterm" name="id3615989"></a><pre class="programlisting">void gtk_tooltips_enable (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips);</pre>
<p>
Allows the user to see your tooltips as they navigate your application.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
<td>a <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3616044"></a><h3>
<a name="gtk-tooltips-disable"></a>gtk_tooltips_disable ()</h3>
<a class="indexterm" name="id3616058"></a><pre class="programlisting">void gtk_tooltips_disable (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips);</pre>
<p>
Causes all tooltips in <em class="parameter"><code>tooltips</code></em> to become inactive. Any widgets that have tips associated with that group will no longer display their tips until they are enabled again with <a href="GtkTooltips.html#gtk-tooltips-enable"><code class="function">gtk_tooltips_enable()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
<td>a <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3616131"></a><h3>
<a name="gtk-tooltips-set-delay"></a>gtk_tooltips_set_delay ()</h3>
<a class="indexterm" name="id3616146"></a><pre class="programlisting">void gtk_tooltips_set_delay (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips,
<a
href="../glib/glib-Basic-Types.html#guint"
>guint</a> delay);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tooltips_set_delay</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the time between the user moving the mouse over a widget and the widget's tooltip appearing.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
<td>a <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>delay</code></em> :</span></td>
<td>an integer value representing milliseconds.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3616236"></a><h3>
<a name="gtk-tooltips-set-tip"></a>gtk_tooltips_set_tip ()</h3>
<a class="indexterm" name="id3616249"></a><pre class="programlisting">void gtk_tooltips_set_tip (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *tip_text,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *tip_private);</pre>
<p>
Adds a tooltip containing the message <em class="parameter"><code>tip_text</code></em> to the specified <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
<td>a <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td>the <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> you wish to associate the tip with.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tip_text</code></em> :</span></td>
<td>a string containing the tip itself.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tip_private</code></em> :</span></td>
<td>a string of any further information that may be useful if the user gets stuck.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3616393"></a><h3>
<a name="gtk-tooltips-data-get"></a>gtk_tooltips_data_get ()</h3>
<a class="indexterm" name="id3616406"></a><pre class="programlisting"><a href="GtkTooltips.html#GtkTooltipsData">GtkTooltipsData</a>* gtk_tooltips_data_get (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<p>
Retrieves any <a href="GtkTooltips.html#GtkTooltipsData"><span class="type">GtkTooltipsData</span></a> previously associated with the given widget.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td>a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a <a href="GtkTooltips.html#GtkTooltipsData"><span class="type">GtkTooltipsData</span></a> struct, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the widget has no tooltip.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3616499"></a><h3>
<a name="gtk-tooltips-force-window"></a>gtk_tooltips_force_window ()</h3>
<a class="indexterm" name="id3616513"></a><pre class="programlisting">void gtk_tooltips_force_window (<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips);</pre>
<p>
Ensures that the window used for displaying the given <em class="parameter"><code>tooltips</code></em> is created.
</p>
<p>
Applications should never have to call this function, since GTK+ takes
care of this.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
<td>a <span class="type">GtkToolTips</span>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3616580"></a><h3>
<a name="gtk-tooltips-get-info-from-tip-window"></a>gtk_tooltips_get_info_from_tip_window ()</h3>
<a class="indexterm" name="id3616596"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gtk_tooltips_get_info_from_tip_window
(<a href="GtkWindow.html" title="GtkWindow">GtkWindow</a> *tip_window,
<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> **tooltips,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> **current_widget);</pre>
<p>
Determines the tooltips and the widget they belong to from the window in
which they are displayed.
</p>
<p>
This function is mostly intended for use by accessibility technologies;
applications should have little use for it.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>tip_window</code></em> :</span></td>
<td> a <a href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
<td> the return location for the tooltips which are displayed
in <em class="parameter"><code>tip_window</code></em>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>current_widget</code></em> :</span></td>
<td> the return location for the widget whose tooltips
are displayed, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>tip_window</code></em> is displaying tooltips, otherwise <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3616775"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a></span></td>
<td><p>Create groups of widgets with their own tooltips.</p></td>
</tr>
<tr>
<td>
<span class="term"><a href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a></span></td>
<td><p>Query tooltips to create context-sensitive help.</p></td>
</tr>
</tbody>
</table></div>
<p>
</p>
</div>
</div>
</body>
</html>