1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>GtkToolItem</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
8
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
9
<link rel="prev" href="GtkToolbar.html" title="GtkToolbar">
10
<link rel="next" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
14
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
15
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
30
<link rel="chapter" href="Printing.html" title="Printing">
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
37
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
48
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
49
<link rel="glossary" href="glossary.html" title="Glossary">
50
<link rel="index" href="ix01.html" title="Index">
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
61
<td><a accesskey="p" href="GtkToolbar.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
62
<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
64
<th width="100%" align="center">GTK+ Reference Manual</th>
65
<td><a accesskey="n" href="GtkSeparatorToolItem.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3390501" class="shortcut">Top</a>
69
<a href="#id3391346" class="shortcut">Description</a>
71
<a href="#id3391127" class="shortcut">Object Hierarchy</a>
73
<a href="#id3391205" class="shortcut">Implemented Interfaces</a>
75
<a href="#id3391228" class="shortcut">Properties</a>
77
<a href="#id3391296" class="shortcut">Signals</a></nobr></td></tr>
79
<div class="refentry" lang="en">
80
<a name="GtkToolItem"></a><div class="titlepage"></div>
81
<div class="refnamediv"><table width="100%"><tr>
84
<a name="id3390501"></a><span class="refentrytitle">GtkToolItem</span>
86
<p>GtkToolItem — The base class of widgets that can be added to GtkToolbar</p>
88
<td valign="top" align="right"></td>
90
<div class="refsynopsisdiv">
92
<pre class="synopsis">
94
#include <gtk/gtk.h>
97
<a href="GtkToolItem.html#GtkToolItem-struct">GtkToolItem</a>;
98
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>* <a href="GtkToolItem.html#gtk-tool-item-new">gtk_tool_item_new</a> (void);
99
void <a href="GtkToolItem.html#gtk-tool-item-set-homogeneous">gtk_tool_item_set_homogeneous</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
100
gboolean homogeneous);
101
gboolean <a href="GtkToolItem.html#gtk-tool-item-get-homogeneous">gtk_tool_item_get_homogeneous</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
102
void <a href="GtkToolItem.html#gtk-tool-item-set-expand">gtk_tool_item_set_expand</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
104
gboolean <a href="GtkToolItem.html#gtk-tool-item-get-expand">gtk_tool_item_get_expand</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
105
void <a href="GtkToolItem.html#gtk-tool-item-set-tooltip">gtk_tool_item_set_tooltip</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
106
<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips,
107
const gchar *tip_text,
108
const gchar *tip_private);
109
void <a href="GtkToolItem.html#gtk-tool-item-set-use-drag-window">gtk_tool_item_set_use_drag_window</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
110
gboolean use_drag_window);
111
gboolean <a href="GtkToolItem.html#gtk-tool-item-get-use-drag-window">gtk_tool_item_get_use_drag_window</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem);
112
void <a href="GtkToolItem.html#gtk-tool-item-set-visible-horizontal">gtk_tool_item_set_visible_horizontal</a>
113
(<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
114
gboolean visible_horizontal);
115
gboolean <a href="GtkToolItem.html#gtk-tool-item-get-visible-horizontal">gtk_tool_item_get_visible_horizontal</a>
116
(<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem);
117
void <a href="GtkToolItem.html#gtk-tool-item-set-visible-vertical">gtk_tool_item_set_visible_vertical</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
118
gboolean visible_vertical);
119
gboolean <a href="GtkToolItem.html#gtk-tool-item-get-visible-vertical">gtk_tool_item_get_visible_vertical</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem);
120
void <a href="GtkToolItem.html#gtk-tool-item-set-is-important">gtk_tool_item_set_is_important</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
121
gboolean is_important);
122
gboolean <a href="GtkToolItem.html#gtk-tool-item-get-is-important">gtk_tool_item_get_is_important</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
123
<a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> <a href="GtkToolItem.html#gtk-tool-item-get-icon-size">gtk_tool_item_get_icon_size</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
124
<a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> <a href="GtkToolItem.html#gtk-tool-item-get-orientation">gtk_tool_item_get_orientation</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
125
<a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> <a href="GtkToolItem.html#gtk-tool-item-get-toolbar-style">gtk_tool_item_get_toolbar_style</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
126
<a href="gtk-Standard-Enumerations.html#GtkReliefStyle">GtkReliefStyle</a> <a href="GtkToolItem.html#gtk-tool-item-get-relief-style">gtk_tool_item_get_relief_style</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
127
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolItem.html#gtk-tool-item-retrieve-proxy-menu-item">gtk_tool_item_retrieve_proxy_menu_item</a>
128
(<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
129
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolItem.html#gtk-tool-item-get-proxy-menu-item">gtk_tool_item_get_proxy_menu_item</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
130
const gchar *menu_item_id);
131
void <a href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item">gtk_tool_item_set_proxy_menu_item</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
132
const gchar *menu_item_id,
133
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_item);
134
void <a href="GtkToolItem.html#gtk-tool-item-rebuild-menu">gtk_tool_item_rebuild_menu</a> (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);
139
<div class="refsect1" lang="en">
140
<a name="id3391127"></a><h2>Object Hierarchy</h2>
141
<pre class="synopsis">
144
+----GInitiallyUnowned
145
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
146
+----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
147
+----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
148
+----<a href="GtkBin.html" title="GtkBin">GtkBin</a>
150
+----<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a>
151
+----<a href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem">GtkSeparatorToolItem</a>
154
<div class="refsect1" lang="en">
155
<a name="id3391205"></a><h2>Implemented Interfaces</h2>
157
GtkToolItem implements
158
AtkImplementorIface.</p>
160
<div class="refsect1" lang="en">
161
<a name="id3391228"></a><h2>Properties</h2>
162
<pre class="synopsis">
164
"<a href="GtkToolItem.html#GtkToolItem--is-important">is-important</a>" gboolean : Read / Write
165
"<a href="GtkToolItem.html#GtkToolItem--visible-horizontal">visible-horizontal</a>" gboolean : Read / Write
166
"<a href="GtkToolItem.html#GtkToolItem--visible-vertical">visible-vertical</a>" gboolean : Read / Write
169
<div class="refsect1" lang="en">
170
<a name="id3391296"></a><h2>Signals</h2>
171
<pre class="synopsis">
173
"<a href="GtkToolItem.html#GtkToolItem-create-menu-proxy">create-menu-proxy</a>" : Run Last
174
"<a href="GtkToolItem.html#GtkToolItem-set-tooltip">set-tooltip</a>" : Run Last
175
"<a href="GtkToolItem.html#GtkToolItem-toolbar-reconfigured">toolbar-reconfigured</a>" : Run Last
178
<div class="refsect1" lang="en">
179
<a name="id3391346"></a><h2>Description</h2>
181
<a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>s are widgets that can appear on a toolbar. To
182
create a toolbar item that contain something else than a button, use
183
<a href="GtkToolItem.html#gtk-tool-item-new"><code class="function">gtk_tool_item_new()</code></a>. Use <a href="GtkContainer.html#gtk-container-add"><code class="function">gtk_container_add()</code></a> to add a child
184
widget to the tool item.
187
For toolbar items that contain buttons, see the <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>,
188
<a href="GtkToggleToolButton.html" title="GtkToggleToolButton"><span class="type">GtkToggleToolButton</span></a> and <a href="GtkRadioToolButton.html" title="GtkRadioToolButton"><span class="type">GtkRadioToolButton</span></a> classes.
190
See the <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> class for a description of the toolbar widget.
194
<div class="refsect1" lang="en">
195
<a name="id3391434"></a><h2>Details</h2>
196
<div class="refsect2" lang="en">
197
<a name="id3391445"></a><h3>
198
<a name="GtkToolItem-struct"></a>GtkToolItem</h3>
199
<a class="indexterm" name="id3391457"></a><pre class="programlisting">typedef struct _GtkToolItem GtkToolItem;</pre>
201
The GtkToolItem struct contains only private data. It should only be
202
accessed through the functions described below.
206
<div class="refsect2" lang="en">
207
<a name="id3391474"></a><h3>
208
<a name="gtk-tool-item-new"></a>gtk_tool_item_new ()</h3>
209
<a class="indexterm" name="id3391490"></a><pre class="programlisting"><a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>* gtk_tool_item_new (void);</pre>
211
Creates a new <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></p>
215
<div class="variablelist"><table border="0">
216
<col align="left" valign="top">
218
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
219
<td> the new <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
224
<p class="since">Since 2.4
228
<div class="refsect2" lang="en">
229
<a name="id3391550"></a><h3>
230
<a name="gtk-tool-item-set-homogeneous"></a>gtk_tool_item_set_homogeneous ()</h3>
231
<a class="indexterm" name="id3391566"></a><pre class="programlisting">void gtk_tool_item_set_homogeneous (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
232
gboolean homogeneous);</pre>
234
Sets whether <em class="parameter"><code>tool_item</code></em> is to be allocated the same size as other
235
homogeneous items. The effect is that all homogeneous items will have
236
the same width as the widest of the items.</p>
240
<div class="variablelist"><table border="0">
241
<col align="left" valign="top">
244
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
245
<td> a <span class="type">GtkToolItem:</span>
249
<td><span class="term"><em class="parameter"><code>homogeneous</code></em> :</span></td>
250
<td> whether <em class="parameter"><code>tool_item</code></em> is the same size as other homogeneous items
255
<p class="since">Since 2.4
259
<div class="refsect2" lang="en">
260
<a name="id3391669"></a><h3>
261
<a name="gtk-tool-item-get-homogeneous"></a>gtk_tool_item_get_homogeneous ()</h3>
262
<a class="indexterm" name="id3391685"></a><pre class="programlisting">gboolean gtk_tool_item_get_homogeneous (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
264
Returns whether <em class="parameter"><code>tool_item</code></em> is the same size as other homogeneous
265
items. See <a href="GtkToolItem.html#gtk-tool-item-set-homogeneous"><code class="function">gtk_tool_item_set_homogeneous()</code></a>.</p>
269
<div class="variablelist"><table border="0">
270
<col align="left" valign="top">
273
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
274
<td> a <span class="type">GtkToolItem:</span>
278
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
279
<td> <code class="literal">TRUE</code> if the item is the same size as other homogeneous
286
<p class="since">Since 2.4
290
<div class="refsect2" lang="en">
291
<a name="id3391789"></a><h3>
292
<a name="gtk-tool-item-set-expand"></a>gtk_tool_item_set_expand ()</h3>
293
<a class="indexterm" name="id3391804"></a><pre class="programlisting">void gtk_tool_item_set_expand (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
294
gboolean expand);</pre>
296
Sets whether <em class="parameter"><code>tool_item</code></em> is allocated extra space when there
297
is more room on the toolbar then needed for the items. The
298
effect is that the item gets bigger when the toolbar gets bigger
299
and smaller when the toolbar gets smaller.</p>
303
<div class="variablelist"><table border="0">
304
<col align="left" valign="top">
307
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
308
<td> a <span class="type">GtkToolItem:</span>
312
<td><span class="term"><em class="parameter"><code>expand</code></em> :</span></td>
313
<td> Whether <em class="parameter"><code>tool_item</code></em> is allocated extra space
318
<p class="since">Since 2.4
322
<div class="refsect2" lang="en">
323
<a name="id3391906"></a><h3>
324
<a name="gtk-tool-item-get-expand"></a>gtk_tool_item_get_expand ()</h3>
325
<a class="indexterm" name="id3391922"></a><pre class="programlisting">gboolean gtk_tool_item_get_expand (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
327
Returns whether <em class="parameter"><code>tool_item</code></em> is allocated extra space.
328
See <a href="GtkToolItem.html#gtk-tool-item-set-expand"><code class="function">gtk_tool_item_set_expand()</code></a>.</p>
332
<div class="variablelist"><table border="0">
333
<col align="left" valign="top">
336
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
337
<td> a <span class="type">GtkToolItem:</span>
341
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
342
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>tool_item</code></em> is allocated extra space.
348
<p class="since">Since 2.4
352
<div class="refsect2" lang="en">
353
<a name="id3392031"></a><h3>
354
<a name="gtk-tool-item-set-tooltip"></a>gtk_tool_item_set_tooltip ()</h3>
355
<a class="indexterm" name="id3392047"></a><pre class="programlisting">void gtk_tool_item_set_tooltip (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
356
<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips,
357
const gchar *tip_text,
358
const gchar *tip_private);</pre>
360
Sets the <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> object to be used for <em class="parameter"><code>tool_item</code></em>, the
361
text to be displayed as tooltip on the item and the private text
362
to be used. See <a href="GtkTooltips.html#gtk-tooltips-set-tip"><code class="function">gtk_tooltips_set_tip()</code></a>.</p>
366
<div class="variablelist"><table border="0">
367
<col align="left" valign="top">
370
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
371
<td> a <span class="type">GtkToolItem:</span>
375
<td><span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
376
<td> The <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a> object to be used
380
<td><span class="term"><em class="parameter"><code>tip_text</code></em> :</span></td>
381
<td> text to be used as tooltip text for <em class="parameter"><code>tool_item</code></em>
385
<td><span class="term"><em class="parameter"><code>tip_private</code></em> :</span></td>
386
<td> text to be used as private tooltip text
391
<p class="since">Since 2.4
395
<div class="refsect2" lang="en">
396
<a name="id3392218"></a><h3>
397
<a name="gtk-tool-item-set-use-drag-window"></a>gtk_tool_item_set_use_drag_window ()</h3>
398
<a class="indexterm" name="id3392235"></a><pre class="programlisting">void gtk_tool_item_set_use_drag_window (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
399
gboolean use_drag_window);</pre>
401
Sets whether <em class="parameter"><code>toolitem</code></em> has a drag window. When <code class="literal">TRUE</code> the
402
toolitem can be used as a drag source through <a href="gtk-Drag-and-Drop.html#gtk-drag-source-set"><code class="function">gtk_drag_source_set()</code></a>.
403
When <em class="parameter"><code>toolitem</code></em> has a drag window it will intercept all events,
404
even those that would otherwise be sent to a child of <em class="parameter"><code>toolitem</code></em>.</p>
408
<div class="variablelist"><table border="0">
409
<col align="left" valign="top">
412
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
413
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
417
<td><span class="term"><em class="parameter"><code>use_drag_window</code></em> :</span></td>
418
<td> Whether <em class="parameter"><code>toolitem</code></em> has a drag window.
423
<p class="since">Since 2.4
427
<div class="refsect2" lang="en">
428
<a name="id3392369"></a><h3>
429
<a name="gtk-tool-item-get-use-drag-window"></a>gtk_tool_item_get_use_drag_window ()</h3>
430
<a class="indexterm" name="id3392385"></a><pre class="programlisting">gboolean gtk_tool_item_get_use_drag_window (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem);</pre>
432
Returns whether <em class="parameter"><code>toolitem</code></em> has a drag window. See
433
<a href="GtkToolItem.html#gtk-tool-item-set-use-drag-window"><code class="function">gtk_tool_item_set_use_drag_window()</code></a>.</p>
437
<div class="variablelist"><table border="0">
438
<col align="left" valign="top">
441
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
442
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
446
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
447
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>toolitem</code></em> uses a drag window.
453
<p class="since">Since 2.4
457
<div class="refsect2" lang="en">
458
<a name="id3392493"></a><h3>
459
<a name="gtk-tool-item-set-visible-horizontal"></a>gtk_tool_item_set_visible_horizontal ()</h3>
460
<a class="indexterm" name="id3392509"></a><pre class="programlisting">void gtk_tool_item_set_visible_horizontal
461
(<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
462
gboolean visible_horizontal);</pre>
464
Sets whether <em class="parameter"><code>toolitem</code></em> is visible when the toolbar is docked horizontally.</p>
468
<div class="variablelist"><table border="0">
469
<col align="left" valign="top">
472
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
473
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
477
<td><span class="term"><em class="parameter"><code>visible_horizontal</code></em> :</span></td>
478
<td> Whether <em class="parameter"><code>toolitem</code></em> is visible when in horizontal mode
483
<p class="since">Since 2.4
487
<div class="refsect2" lang="en">
488
<a name="id3392610"></a><h3>
489
<a name="gtk-tool-item-get-visible-horizontal"></a>gtk_tool_item_get_visible_horizontal ()</h3>
490
<a class="indexterm" name="id3392626"></a><pre class="programlisting">gboolean gtk_tool_item_get_visible_horizontal
491
(<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem);</pre>
493
Returns whether the <em class="parameter"><code>toolitem</code></em> is visible on toolbars that are
494
docked horizontally.</p>
498
<div class="variablelist"><table border="0">
499
<col align="left" valign="top">
502
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
503
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
507
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
508
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>toolitem</code></em> is visible on toolbars that are
515
<p class="since">Since 2.4
519
<div class="refsect2" lang="en">
520
<a name="id3392726"></a><h3>
521
<a name="gtk-tool-item-set-visible-vertical"></a>gtk_tool_item_set_visible_vertical ()</h3>
522
<a class="indexterm" name="id3392743"></a><pre class="programlisting">void gtk_tool_item_set_visible_vertical (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
523
gboolean visible_vertical);</pre>
525
Sets whether <em class="parameter"><code>toolitem</code></em> is visible when the toolbar is docked
526
vertically. Some tool items, such as text entries, are too wide to be
527
useful on a vertically docked toolbar. If <em class="parameter"><code>visible_vertical</code></em> is <code class="literal">FALSE</code>
528
<em class="parameter"><code>toolitem</code></em> will not appear on toolbars that are docked vertically.</p>
532
<div class="variablelist"><table border="0">
533
<col align="left" valign="top">
536
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
537
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
541
<td><span class="term"><em class="parameter"><code>visible_vertical</code></em> :</span></td>
542
<td> whether <em class="parameter"><code>toolitem</code></em> is visible when the toolbar
548
<p class="since">Since 2.4
552
<div class="refsect2" lang="en">
553
<a name="id3392867"></a><h3>
554
<a name="gtk-tool-item-get-visible-vertical"></a>gtk_tool_item_get_visible_vertical ()</h3>
555
<a class="indexterm" name="id3392883"></a><pre class="programlisting">gboolean gtk_tool_item_get_visible_vertical (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem);</pre>
557
Returns whether <em class="parameter"><code>toolitem</code></em> is visible when the toolbar is docked vertically.
558
See <a href="GtkToolItem.html#gtk-tool-item-set-visible-vertical"><code class="function">gtk_tool_item_set_visible_vertical()</code></a>.</p>
562
<div class="variablelist"><table border="0">
563
<col align="left" valign="top">
566
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
567
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
571
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
572
<td> Whether <em class="parameter"><code>toolitem</code></em> is visible when the toolbar is docked vertically
578
<p class="since">Since 2.4
582
<div class="refsect2" lang="en">
583
<a name="id3392982"></a><h3>
584
<a name="gtk-tool-item-set-is-important"></a>gtk_tool_item_set_is_important ()</h3>
585
<a class="indexterm" name="id3392998"></a><pre class="programlisting">void gtk_tool_item_set_is_important (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
586
gboolean is_important);</pre>
588
Sets whether <em class="parameter"><code>tool_item</code></em> should be considered important. The <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
589
class uses this property to determine whether to show or hide its label
590
when the toolbar style is <a href="gtk-Standard-Enumerations.html#GTK-TOOLBAR-BOTH-HORIZ:CAPS"><code class="literal">GTK_TOOLBAR_BOTH_HORIZ</code></a>. The result is that
591
only tool buttons with the "is_important" property set have labels, an
592
effect known as "priority text"</p>
596
<div class="variablelist"><table border="0">
597
<col align="left" valign="top">
600
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
601
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
605
<td><span class="term"><em class="parameter"><code>is_important</code></em> :</span></td>
606
<td> whether the tool item should be considered important
611
<p class="since">Since 2.4
615
<div class="refsect2" lang="en">
616
<a name="id3393115"></a><h3>
617
<a name="gtk-tool-item-get-is-important"></a>gtk_tool_item_get_is_important ()</h3>
618
<a class="indexterm" name="id3393131"></a><pre class="programlisting">gboolean gtk_tool_item_get_is_important (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
620
Returns whether <em class="parameter"><code>tool_item</code></em> is considered important. See
621
<a href="GtkToolItem.html#gtk-tool-item-set-is-important"><code class="function">gtk_tool_item_set_is_important()</code></a></p>
625
<div class="variablelist"><table border="0">
626
<col align="left" valign="top">
629
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
630
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
634
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
635
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>tool_item</code></em> is considered important.
641
<p class="since">Since 2.4
645
<div class="refsect2" lang="en">
646
<a name="id3393239"></a><h3>
647
<a name="gtk-tool-item-get-icon-size"></a>gtk_tool_item_get_icon_size ()</h3>
648
<a class="indexterm" name="id3393255"></a><pre class="programlisting"><a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> gtk_tool_item_get_icon_size (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
650
Returns the icon size used for <em class="parameter"><code>tool_item</code></em>. Custom subclasses of
651
<a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function to find out what size icons
656
<div class="variablelist"><table border="0">
657
<col align="left" valign="top">
660
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
661
<td> a <span class="type">GtkToolItem:</span>
665
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
666
<td> a <a href="gtk-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a> indicating the icon size used for <em class="parameter"><code>tool_item</code></em>
672
<p class="since">Since 2.4
676
<div class="refsect2" lang="en">
677
<a name="id3393359"></a><h3>
678
<a name="gtk-tool-item-get-orientation"></a>gtk_tool_item_get_orientation ()</h3>
679
<a class="indexterm" name="id3393375"></a><pre class="programlisting"><a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> gtk_tool_item_get_orientation (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
681
Returns the orientation used for <em class="parameter"><code>tool_item</code></em>. Custom subclasses of
682
<a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function to find out what size icons
687
<div class="variablelist"><table border="0">
688
<col align="left" valign="top">
691
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
692
<td> a <span class="type">GtkToolItem:</span>
696
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
697
<td> a <a href="gtk-Standard-Enumerations.html#GtkOrientation"><span class="type">GtkOrientation</span></a> indicating the orientation
698
used for <em class="parameter"><code>tool_item</code></em>
704
<p class="since">Since 2.4
708
<div class="refsect2" lang="en">
709
<a name="id3393481"></a><h3>
710
<a name="gtk-tool-item-get-toolbar-style"></a>gtk_tool_item_get_toolbar_style ()</h3>
711
<a class="indexterm" name="id3393497"></a><pre class="programlisting"><a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> gtk_tool_item_get_toolbar_style (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
713
Returns the toolbar style used for <em class="parameter"><code>tool_item</code></em>. Custom subclasses of
714
<a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function in the handler of the
715
GtkToolItem::toolbar_reconfigured signal to find out in what style
716
the toolbar is displayed and change themselves accordingly
721
<div class="itemizedlist"><ul type="disc">
722
<li> GTK_TOOLBAR_BOTH, meaning the tool item should show
723
both an icon and a label, stacked vertically </li>
724
<li> GTK_TOOLBAR_ICONS, meaning the toolbar shows
726
<li> GTK_TOOLBAR_TEXT, meaning the tool item should only
728
<li> GTK_TOOLBAR_BOTH_HORIZ, meaning the tool item should show
729
both an icon and a label, arranged horizontally (however, note the
730
<span class="type">GtkToolButton::has_text_horizontally</span> that makes tool buttons not
731
show labels when the toolbar style is GTK_TOOLBAR_BOTH_HORIZ.
737
<div class="variablelist"><table border="0">
738
<col align="left" valign="top">
741
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
742
<td> a <span class="type">GtkToolItem:</span>
746
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
747
<td> A <a href="gtk-Standard-Enumerations.html#GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> indicating the toolbar style used
748
for <em class="parameter"><code>tool_item</code></em>.
754
<p class="since">Since 2.4
758
<div class="refsect2" lang="en">
759
<a name="id3393641"></a><h3>
760
<a name="gtk-tool-item-get-relief-style"></a>gtk_tool_item_get_relief_style ()</h3>
761
<a class="indexterm" name="id3393657"></a><pre class="programlisting"><a href="gtk-Standard-Enumerations.html#GtkReliefStyle">GtkReliefStyle</a> gtk_tool_item_get_relief_style (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
763
Returns the relief style of <em class="parameter"><code>tool_item</code></em>. See <code class="function">gtk_button_set_relief_style()</code>.
764
Custom subclasses of <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should call this function in the handler
765
of the <a href="GtkToolItem.html#GtkToolItem-toolbar-reconfigured"><span class="type">GtkToolItem::toolbar_reconfigured</span></a> signal to find out the
766
relief style of buttons.</p>
770
<div class="variablelist"><table border="0">
771
<col align="left" valign="top">
774
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
775
<td> a <span class="type">GtkToolItem:</span>
779
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
780
<td> a <a href="gtk-Standard-Enumerations.html#GtkReliefStyle"><span class="type">GtkReliefStyle</span></a> indicating the relief style used
781
for <em class="parameter"><code>tool_item</code></em>.
787
<p class="since">Since 2.4
791
<div class="refsect2" lang="en">
792
<a name="id3393784"></a><h3>
793
<a name="gtk-tool-item-retrieve-proxy-menu-item"></a>gtk_tool_item_retrieve_proxy_menu_item ()</h3>
794
<a class="indexterm" name="id3393800"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_tool_item_retrieve_proxy_menu_item
795
(<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
797
Returns the <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> that was last set by
798
<a href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a>, ie. the <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>
799
that is going to appear in the overflow menu.</p>
803
<div class="variablelist"><table border="0">
804
<col align="left" valign="top">
807
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
808
<td> a <span class="type">GtkToolItem:</span>
812
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
813
<td> The <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> that is going to appear in the
814
overflow menu for <em class="parameter"><code>tool_item</code></em>.
820
<p class="since">Since 2.4
824
<div class="refsect2" lang="en">
825
<a name="id3393919"></a><h3>
826
<a name="gtk-tool-item-get-proxy-menu-item"></a>gtk_tool_item_get_proxy_menu_item ()</h3>
827
<a class="indexterm" name="id3393936"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_tool_item_get_proxy_menu_item (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
828
const gchar *menu_item_id);</pre>
830
If <em class="parameter"><code>menu_item_id</code></em> matches the string passed to
831
<a href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a> return the corresponding <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>.
834
Custom subclasses of <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> should use this function to update
835
their menu item when the <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> changes. That the
836
<em class="parameter"><code>menu_item_id</code></em>s must match ensures that a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> will not
837
inadvertently change a menu item that they did not create.</p>
841
<div class="variablelist"><table border="0">
842
<col align="left" valign="top">
845
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
846
<td> a <span class="type">GtkToolItem:</span>
850
<td><span class="term"><em class="parameter"><code>menu_item_id</code></em> :</span></td>
851
<td> a string used to identify the menu item
855
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
856
<td> The <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> passed to
857
<a href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a>, if the <em class="parameter"><code>menu_item_id</code></em>s match.
863
<p class="since">Since 2.4
867
<div class="refsect2" lang="en">
868
<a name="id3394124"></a><h3>
869
<a name="gtk-tool-item-set-proxy-menu-item"></a>gtk_tool_item_set_proxy_menu_item ()</h3>
870
<a class="indexterm" name="id3394140"></a><pre class="programlisting">void gtk_tool_item_set_proxy_menu_item (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
871
const gchar *menu_item_id,
872
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *menu_item);</pre>
874
Sets the <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> used in the toolbar overflow menu. The
875
<em class="parameter"><code>menu_item_id</code></em> is used to identify the caller of this function and
876
should also be used with <a href="GtkToolItem.html#gtk-tool-item-get-proxy-menu-item"><code class="function">gtk_tool_item_get_proxy_menu_item()</code></a>.</p>
880
<div class="variablelist"><table border="0">
881
<col align="left" valign="top">
884
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
885
<td> a <span class="type">GtkToolItem:</span>
889
<td><span class="term"><em class="parameter"><code>menu_item_id</code></em> :</span></td>
890
<td> a string used to identify <em class="parameter"><code>menu_item</code></em>
894
<td><span class="term"><em class="parameter"><code>menu_item</code></em> :</span></td>
895
<td> a <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to be used in the overflow menu
900
<p class="since">Since 2.4
904
<div class="refsect2" lang="en">
905
<a name="id3394289"></a><h3>
906
<a name="gtk-tool-item-rebuild-menu"></a>gtk_tool_item_rebuild_menu ()</h3>
907
<a class="indexterm" name="id3394306"></a><pre class="programlisting">void gtk_tool_item_rebuild_menu (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item);</pre>
909
Calling this function signals to the toolbar that the
910
overflow menu item for <em class="parameter"><code>tool_item</code></em> has changed. If the
911
overflow menu is visible when this function it called,
912
the menu will be rebuilt.
915
The function must be called when the tool item
916
changes what it will do in response to the "create_menu_proxy"
921
<div class="variablelist"><table border="0">
922
<col align="left" valign="top">
924
<td><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
925
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
929
<p class="since">Since 2.6
933
<div class="refsect1" lang="en">
934
<a name="id3394385"></a><h2>Property Details</h2>
935
<div class="refsect2" lang="en">
936
<a name="id3394395"></a><h3>
937
<a name="GtkToolItem--is-important"></a>The "<code class="literal">is-important</code>" property</h3>
938
<a class="indexterm" name="id3394412"></a><pre class="programlisting"> "is-important" gboolean : Read / Write</pre>
939
<p>Whether the toolbar item is considered important. When TRUE, toolbar buttons show text in GTK_TOOLBAR_BOTH_HORIZ mode.</p>
940
<p>Default value: FALSE</p>
943
<div class="refsect2" lang="en">
944
<a name="id3394440"></a><h3>
945
<a name="GtkToolItem--visible-horizontal"></a>The "<code class="literal">visible-horizontal</code>" property</h3>
946
<a class="indexterm" name="id3394457"></a><pre class="programlisting"> "visible-horizontal" gboolean : Read / Write</pre>
947
<p>Whether the toolbar item is visible when the toolbar is in a horizontal orientation.</p>
948
<p>Default value: TRUE</p>
951
<div class="refsect2" lang="en">
952
<a name="id3394485"></a><h3>
953
<a name="GtkToolItem--visible-vertical"></a>The "<code class="literal">visible-vertical</code>" property</h3>
954
<a class="indexterm" name="id3394502"></a><pre class="programlisting"> "visible-vertical" gboolean : Read / Write</pre>
955
<p>Whether the toolbar item is visible when the toolbar is in a vertical orientation.</p>
956
<p>Default value: TRUE</p>
959
<div class="refsect1" lang="en">
960
<a name="id3394531"></a><h2>Signal Details</h2>
961
<div class="refsect2" lang="en">
962
<a name="id3394541"></a><h3>
963
<a name="GtkToolItem-create-menu-proxy"></a>The "create-menu-proxy" signal</h3>
964
<a class="indexterm" name="id3394553"></a><pre class="programlisting">gboolean user_function (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
965
gpointer user_data) : Run Last</pre>
967
This signal is emitted when the toolbar needs information from <em class="parameter"><code>tool_item</code></em>
968
about whether the item should appear in the toolbar overflow menu. In
969
response the tool item should either
971
<div class="itemizedlist"><ul type="disc">
972
<li> call <a href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a> with a <a
973
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
974
><code class="literal">NULL</code></a>
975
pointer and return <code class="literal">TRUE</code> to indicate that the item should not appear
978
<li> call <a href="GtkToolItem.html#gtk-tool-item-set-proxy-menu-item"><code class="function">gtk_tool_item_set_proxy_menu_item()</code></a> with a new menu
979
item and return <code class="literal">TRUE</code>, or
981
<li> return <code class="literal">FALSE</code> to indicate that the signal was not
982
handled by the item. This means that
983
the item will not appear in the overflow menu unless a later handler
984
installs a menu item.
990
The toolbar may cache the result of this signal. When the tool item changes
991
how it will respond to this signal it must call <a href="GtkToolItem.html#gtk-tool-item-rebuild-menu"><code class="function">gtk_tool_item_rebuild_menu()</code></a>
992
to invalidate the cache and ensure that the toolbar rebuilds its overflow
997
<div class="variablelist"><table border="0">
998
<col align="left" valign="top">
1001
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
1002
<td> the object the signal was emitted on
1006
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
1007
<td>user data set when the signal handler was connected.</td>
1010
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1011
<td> <code class="literal">TRUE</code> if the signal was handled, <code class="literal">FALSE</code> if not
1018
<div class="refsect2" lang="en">
1019
<a name="id3394764"></a><h3>
1020
<a name="GtkToolItem-set-tooltip"></a>The "set-tooltip" signal</h3>
1021
<a class="indexterm" name="id3394774"></a><pre class="programlisting">gboolean user_function (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
1022
<a href="GtkTooltips.html" title="GtkTooltips">GtkTooltips</a> *tooltips,
1025
gpointer user_data) : Run Last</pre>
1027
This signal is emitted when the toolitem's tooltip changes.
1028
Application developers can use <a href="GtkToolItem.html#gtk-tool-item-set-tooltip"><code class="function">gtk_tool_item_set_tooltip()</code></a> to
1029
set the item's tooltip.</p>
1033
<div class="variablelist"><table border="0">
1034
<col align="left" valign="top">
1037
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
1038
<td> the object the signal was emitted on
1042
<td><span class="term"><em class="parameter"><code>tooltips</code></em> :</span></td>
1043
<td> the <a href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a>
1047
<td><span class="term"><em class="parameter"><code>tip_text</code></em> :</span></td>
1048
<td> the tooltip text
1052
<td><span class="term"><em class="parameter"><code>tip_private</code></em> :</span></td>
1053
<td> the tooltip private text
1057
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
1058
<td>user data set when the signal handler was connected.</td>
1061
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
1062
<td> <code class="literal">TRUE</code> if the signal was handled, <code class="literal">FALSE</code> if not
1069
<div class="refsect2" lang="en">
1070
<a name="id3394963"></a><h3>
1071
<a name="GtkToolItem-toolbar-reconfigured"></a>The "toolbar-reconfigured" signal</h3>
1072
<a class="indexterm" name="id3394975"></a><pre class="programlisting">void user_function (<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *toolitem,
1073
gpointer user_data) : Run Last</pre>
1075
This signal is emitted when some property of the toolbar that the
1076
item is a child of changes. For custom subclasses of <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>,
1077
the default handler of this signal use the functions
1079
<div class="itemizedlist"><ul type="disc">
1080
<li><a href="GtkToolbar.html#gtk-toolbar-get-orientation"><code class="function">gtk_toolbar_get_orientation()</code></a></li>
1081
<li><a href="GtkToolbar.html#gtk-toolbar-get-style"><code class="function">gtk_toolbar_get_style()</code></a></li>
1082
<li><a href="GtkToolbar.html#gtk-toolbar-get-icon-size"><code class="function">gtk_toolbar_get_icon_size()</code></a></li>
1083
<li><a href="GtkToolbar.html#gtk-toolbar-get-relief-style"><code class="function">gtk_toolbar_get_relief_style()</code></a></li>
1086
to find out what the toolbar should look like and change
1087
themselves accordingly.</p>
1091
<div class="variablelist"><table border="0">
1092
<col align="left" valign="top">
1095
<td><span class="term"><em class="parameter"><code>toolitem</code></em> :</span></td>
1096
<td> the object the signal was emitted on
1100
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
1101
<td>user data set when the signal handler was connected.</td>
1107
<div class="refsect1" lang="en">
1108
<a name="id3395112"></a><h2>See Also</h2>
1111
<dt><span class="term"><a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a></span></dt><dd><p>The toolbar widget</p></dd>
1113
<dt><span class="term"><a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a></span></dt><dd><p>A subclass of <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> that displays buttons on
1114
the toolbar</p></dd>
1116
<dt><span class="term"><a href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a></span></dt><dd><p>A subclass of <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> that separates groups of
1117
items on a toolbar</p></dd>