~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkTooltip.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
44
44
 
45
45
                    <a class="link" href="GtkTooltip.html#GtkTooltip-struct" title="GtkTooltip">GtkTooltip</a>;
46
46
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-markup" title="gtk_tooltip_set_markup ()">gtk_tooltip_set_markup</a>              (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
47
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);
 
47
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);
48
48
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-text" title="gtk_tooltip_set_text ()">gtk_tooltip_set_text</a>                (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
49
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);
 
49
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);
50
50
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-icon" title="gtk_tooltip_set_icon ()">gtk_tooltip_set_icon</a>                (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
51
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
 
51
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
52
52
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-icon-from-stock" title="gtk_tooltip_set_icon_from_stock ()">gtk_tooltip_set_icon_from_stock</a>     (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
53
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
 
53
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
54
54
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);
55
55
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-icon-from-icon-name" title="gtk_tooltip_set_icon_from_icon_name ()">gtk_tooltip_set_icon_from_icon_name</a> (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
56
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
 
56
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
57
57
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);
58
58
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-icon-from-gicon" title="gtk_tooltip_set_icon_from_gicon ()">gtk_tooltip_set_icon_from_gicon</a>     (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
59
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GIcon.html"><span class="type">GIcon</span></a> *gicon</code></em>,
 
59
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *gicon</code></em>,
60
60
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-custom" title="gtk_tooltip_set_custom ()">gtk_tooltip_set_custom</a>              (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
62
62
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *custom_widget</code></em>);
63
 
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-trigger-tooltip-query" title="gtk_tooltip_trigger_tooltip_query ()">gtk_tooltip_trigger_tooltip_query</a>   (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);
 
63
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-trigger-tooltip-query" title="gtk_tooltip_trigger_tooltip_query ()">gtk_tooltip_trigger_tooltip_query</a>   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);
64
64
<span class="returnvalue">void</span>                <a class="link" href="GtkTooltip.html#gtk-tooltip-set-tip-area" title="gtk_tooltip_set_tip_area ()">gtk_tooltip_set_tip_area</a>            (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
65
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gdk/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);
 
65
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);
66
66
</pre>
67
67
</div>
68
68
<div class="refsect1" title="Object Hierarchy">
69
69
<a name="GtkTooltip.object-hierarchy"></a><h2>Object Hierarchy</h2>
70
70
<pre class="synopsis">
71
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
71
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
72
72
   +----GtkTooltip
73
73
</pre>
74
74
</div>
90
90
</p>
91
91
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
92
92
<li class="listitem"><p>
93
 
Set the <a class="link" href="GtkWidget.html#GtkWidget--has-tooltip" title='The "has-tooltip" property'><span class="type">"has-tooltip"</span></a> property to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this will
 
93
Set the <a class="link" href="GtkWidget.html#GtkWidget--has-tooltip" title='The "has-tooltip" property'><span class="type">"has-tooltip"</span></a> property to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this will
94
94
make GTK+ monitor the widget for motion and related events
95
95
which are needed to determine when and where to show a tooltip.
96
96
</p></li>
105
105
even putting in a custom widget.
106
106
</p></li>
107
107
<li class="listitem"><p>
108
 
Return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> from your query-tooltip handler. This causes
109
 
the tooltip to be show. If you return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, it will not be shown.
 
108
Return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> from your query-tooltip handler. This causes
 
109
the tooltip to be show. If you return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, it will not be shown.
110
110
</p></li>
111
111
</ul></div>
112
112
<p>
130
130
In the ::query-tooltip callback you can access your window
131
131
using <a class="link" href="GtkWidget.html#gtk-widget-get-tooltip-window" title="gtk_widget_get_tooltip_window ()"><code class="function">gtk_widget_get_tooltip_window()</code></a> and manipulate as you
132
132
wish. The semantics of the return value are exactly as before,
133
 
return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to show the window, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to not show it.
 
133
return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to show the window, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to not show it.
134
134
</p></li>
135
135
</ul></div>
136
136
<p>
148
148
<div class="refsect2" title="gtk_tooltip_set_markup ()">
149
149
<a name="gtk-tooltip-set-markup"></a><h3>gtk_tooltip_set_markup ()</h3>
150
150
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_set_markup              (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
151
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);</pre>
 
151
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);</pre>
152
152
<p>
153
153
Sets the text of the tooltip to be <em class="parameter"><code>markup</code></em>, which is marked up
154
154
with the <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>.
155
 
If <em class="parameter"><code>markup</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label will be hidden.
 
155
If <em class="parameter"><code>markup</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label will be hidden.
156
156
</p>
157
157
<div class="variablelist"><table border="0">
158
158
<col align="left" valign="top">
164
164
</tr>
165
165
<tr>
166
166
<td><p><span class="term"><em class="parameter"><code>markup</code></em> :</span></p></td>
167
 
<td> a markup string (see <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>) or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
167
<td> a markup string (see <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>) or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
168
168
</td>
169
169
</tr>
170
170
</tbody>
175
175
<div class="refsect2" title="gtk_tooltip_set_text ()">
176
176
<a name="gtk-tooltip-set-text"></a><h3>gtk_tooltip_set_text ()</h3>
177
177
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_set_text                (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
178
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
 
178
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *text</code></em>);</pre>
179
179
<p>
180
 
Sets the text of the tooltip to be <em class="parameter"><code>text</code></em>. If <em class="parameter"><code>text</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label
 
180
Sets the text of the tooltip to be <em class="parameter"><code>text</code></em>. If <em class="parameter"><code>text</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the label
181
181
will be hidden. See also <a class="link" href="GtkTooltip.html#gtk-tooltip-set-markup" title="gtk_tooltip_set_markup ()"><code class="function">gtk_tooltip_set_markup()</code></a>.
182
182
</p>
183
183
<div class="variablelist"><table border="0">
190
190
</tr>
191
191
<tr>
192
192
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
193
 
<td> a text string or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
193
<td> a text string or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
194
194
</td>
195
195
</tr>
196
196
</tbody>
201
201
<div class="refsect2" title="gtk_tooltip_set_icon ()">
202
202
<a name="gtk-tooltip-set-icon"></a><h3>gtk_tooltip_set_icon ()</h3>
203
203
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_set_icon                (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
204
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
 
204
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
205
205
<p>
206
206
Sets the icon of the tooltip (which is in front of the text) to be
207
 
<em class="parameter"><code>pixbuf</code></em>.  If <em class="parameter"><code>pixbuf</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
 
207
<em class="parameter"><code>pixbuf</code></em>.  If <em class="parameter"><code>pixbuf</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
208
208
</p>
209
209
<div class="variablelist"><table border="0">
210
210
<col align="left" valign="top">
216
216
</tr>
217
217
<tr>
218
218
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
219
 
<td> a <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
219
<td> a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
220
220
</td>
221
221
</tr>
222
222
</tbody>
227
227
<div class="refsect2" title="gtk_tooltip_set_icon_from_stock ()">
228
228
<a name="gtk-tooltip-set-icon-from-stock"></a><h3>gtk_tooltip_set_icon_from_stock ()</h3>
229
229
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_set_icon_from_stock     (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
230
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
 
230
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *stock_id</code></em>,
231
231
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
232
232
<p>
233
233
Sets the icon of the tooltip (which is in front of the text) to be
234
234
the stock item indicated by <em class="parameter"><code>stock_id</code></em> with the size indicated
235
 
by <em class="parameter"><code>size</code></em>.  If <em class="parameter"><code>stock_id</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
 
235
by <em class="parameter"><code>size</code></em>.  If <em class="parameter"><code>stock_id</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
236
236
</p>
237
237
<div class="variablelist"><table border="0">
238
238
<col align="left" valign="top">
244
244
</tr>
245
245
<tr>
246
246
<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td>
247
 
<td> a stock id, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
247
<td> a stock id, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
248
248
</td>
249
249
</tr>
250
250
<tr>
260
260
<div class="refsect2" title="gtk_tooltip_set_icon_from_icon_name ()">
261
261
<a name="gtk-tooltip-set-icon-from-icon-name"></a><h3>gtk_tooltip_set_icon_from_icon_name ()</h3>
262
262
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_set_icon_from_icon_name (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
263
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
 
263
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>,
264
264
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
265
265
<p>
266
266
Sets the icon of the tooltip (which is in front of the text) to be
267
267
the icon indicated by <em class="parameter"><code>icon_name</code></em> with the size indicated
268
 
by <em class="parameter"><code>size</code></em>.  If <em class="parameter"><code>icon_name</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
 
268
by <em class="parameter"><code>size</code></em>.  If <em class="parameter"><code>icon_name</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
269
269
</p>
270
270
<div class="variablelist"><table border="0">
271
271
<col align="left" valign="top">
277
277
</tr>
278
278
<tr>
279
279
<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td>
280
 
<td> an icon name, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
280
<td> an icon name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
281
281
</td>
282
282
</tr>
283
283
<tr>
293
293
<div class="refsect2" title="gtk_tooltip_set_icon_from_gicon ()">
294
294
<a name="gtk-tooltip-set-icon-from-gicon"></a><h3>gtk_tooltip_set_icon_from_gicon ()</h3>
295
295
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_set_icon_from_gicon     (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
296
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GIcon.html"><span class="type">GIcon</span></a> *gicon</code></em>,
 
296
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> *gicon</code></em>,
297
297
                                                         <em class="parameter"><code><a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
298
298
<p>
299
299
Sets the icon of the tooltip (which is in front of the text)
300
300
to be the icon indicated by <em class="parameter"><code>gicon</code></em> with the size indicated
301
 
by <em class="parameter"><code>size</code></em>. If <em class="parameter"><code>gicon</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
 
301
by <em class="parameter"><code>size</code></em>. If <em class="parameter"><code>gicon</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the image will be hidden.
302
302
</p>
303
303
<div class="variablelist"><table border="0">
304
304
<col align="left" valign="top">
310
310
</tr>
311
311
<tr>
312
312
<td><p><span class="term"><em class="parameter"><code>gicon</code></em> :</span></p></td>
313
 
<td> a <a href="/usr/share/gtk-doc/html/gio/GIcon.html"><span class="type">GIcon</span></a> representing the icon, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
313
<td> a <a href="http://library.gnome.org/devel/gio/unstable/GIcon.html"><span class="type">GIcon</span></a> representing the icon, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
314
314
</td>
315
315
</tr>
316
316
<tr>
345
345
</tr>
346
346
<tr>
347
347
<td><p><span class="term"><em class="parameter"><code>custom_widget</code></em> :</span></p></td>
348
 
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the old custom widget. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
348
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the old custom widget. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
349
349
</td>
350
350
</tr>
351
351
</tbody>
355
355
<hr>
356
356
<div class="refsect2" title="gtk_tooltip_trigger_tooltip_query ()">
357
357
<a name="gtk-tooltip-trigger-tooltip-query"></a><h3>gtk_tooltip_trigger_tooltip_query ()</h3>
358
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_trigger_tooltip_query   (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
 
358
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_trigger_tooltip_query   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
359
359
<p>
360
360
Triggers a new tooltip query on <em class="parameter"><code>display</code></em>, in order to update the current
361
361
visible tooltip, or to show/hide the current tooltip.  This function is
366
366
<col align="left" valign="top">
367
367
<tbody><tr>
368
368
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
369
 
<td>a <a href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a>
 
369
<td>a <a href="http://library.gnome.org/devel/gdk/unstable/GdkDisplay.html"><span class="type">GdkDisplay</span></a>
370
370
</td>
371
371
</tr></tbody>
372
372
</table></div>
376
376
<div class="refsect2" title="gtk_tooltip_set_tip_area ()">
377
377
<a name="gtk-tooltip-set-tip-area"></a><h3>gtk_tooltip_set_tip_area ()</h3>
378
378
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_tooltip_set_tip_area            (<em class="parameter"><code><a class="link" href="GtkTooltip.html" title="GtkTooltip"><span class="type">GtkTooltip</span></a> *tooltip</code></em>,
379
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gdk/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
 
379
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *rect</code></em>);</pre>
380
380
<p>
381
381
Sets the area of the widget, where the contents of this tooltip apply,
382
382
to be <em class="parameter"><code>rect</code></em> (in widget coordinates).  This is especially useful for
398
398
</tr>
399
399
<tr>
400
400
<td><p><span class="term"><em class="parameter"><code>rect</code></em> :</span></p></td>
401
 
<td>a <a href="/usr/share/gtk-doc/html/gdk/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a>
 
401
<td>a <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a>
402
402
</td>
403
403
</tr>
404
404
</tbody>