← Back to branch summary

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

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkToolButton.html
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
5
<title>GtkToolButton</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="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem">
 
10
<link rel="next" href="GtkMenuToolButton.html" title="GtkMenuToolButton">
 
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&#160;I.&#160;GTK+ Overview">
 
14
<link rel="part" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
 
15
<link rel="part" href="gtkobjects.html" title="Part&#160;III.&#160;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&#160;IV.&#160;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&#160;V.&#160;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">
 
57
</head>
 
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">
 
60
<tr valign="middle">
 
61
<td><a accesskey="p" href="GtkSeparatorToolItem.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="GtkMenuToolButton.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
66
</tr>
 
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3401414" class="shortcut">Top</a>
 
68
                  &#160;|&#160;
 
69
                  <a href="#id3402113" class="shortcut">Description</a>
 
70
                  &#160;|&#160;
 
71
                  <a href="#id3401821" class="shortcut">Object Hierarchy</a>
 
72
                  &#160;|&#160;
 
73
                  <a href="#id3401906" class="shortcut">Implemented Interfaces</a>
 
74
                  &#160;|&#160;
 
75
                  <a href="#id3401929" class="shortcut">Properties</a>
 
76
                  &#160;|&#160;
 
77
                  <a href="#id3402050" class="shortcut">Style Properties</a>
 
78
                  &#160;|&#160;
 
79
                  <a href="#id3402084" class="shortcut">Signals</a></nobr></td></tr>
 
80
</table>
 
81
<div class="refentry" lang="en">
 
82
<a name="GtkToolButton"></a><div class="titlepage"></div>
 
83
<div class="refnamediv"><table width="100%"><tr>
 
84
<td valign="top">
 
85
<h2>
 
86
<a name="id3401414"></a><span class="refentrytitle">GtkToolButton</span>
 
87
</h2>
 
88
<p>GtkToolButton &#8212; A GtkToolItem subclass that displays buttons</p>
 
89
</td>
 
90
<td valign="top" align="right"></td>
 
91
</tr></table></div>
 
92
<div class="refsynopsisdiv">
 
93
<h2>Synopsis</h2>
 
94
<pre class="synopsis">
 
95
 
 
96
#include &lt;gtk/gtk.h&gt;
 
97
 
 
98
 
 
99
                    <a href="GtkToolButton.html#GtkToolButton-struct">GtkToolButton</a>;
 
100
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>*        <a href="GtkToolButton.html#gtk-tool-button-new">gtk_tool_button_new</a>                 (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon_widget,
 
101
                                                         const gchar *label);
 
102
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>*        <a href="GtkToolButton.html#gtk-tool-button-new-from-stock">gtk_tool_button_new_from_stock</a>      (const gchar *stock_id);
 
103
void                <a href="GtkToolButton.html#gtk-tool-button-set-label">gtk_tool_button_set_label</a>           (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
104
                                                         const gchar *label);
 
105
const gchar*        <a href="GtkToolButton.html#gtk-tool-button-get-label">gtk_tool_button_get_label</a>           (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);
 
106
void                <a href="GtkToolButton.html#gtk-tool-button-set-use-underline">gtk_tool_button_set_use_underline</a>   (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
107
                                                         gboolean use_underline);
 
108
gboolean            <a href="GtkToolButton.html#gtk-tool-button-get-use-underline">gtk_tool_button_get_use_underline</a>   (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);
 
109
void                <a href="GtkToolButton.html#gtk-tool-button-set-stock-id">gtk_tool_button_set_stock_id</a>        (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
110
                                                         const gchar *stock_id);
 
111
const gchar*        <a href="GtkToolButton.html#gtk-tool-button-get-stock-id">gtk_tool_button_get_stock_id</a>        (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);
 
112
void                <a href="GtkToolButton.html#gtk-tool-button-set-icon-name">gtk_tool_button_set_icon_name</a>       (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
113
                                                         const gchar *icon_name);
 
114
const gchar*        <a href="GtkToolButton.html#gtk-tool-button-get-icon-name">gtk_tool_button_get_icon_name</a>       (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);
 
115
void                <a href="GtkToolButton.html#gtk-tool-button-set-icon-widget">gtk_tool_button_set_icon_widget</a>     (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
116
                                                         <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon_widget);
 
117
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkToolButton.html#gtk-tool-button-get-icon-widget">gtk_tool_button_get_icon_widget</a>     (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);
 
118
void                <a href="GtkToolButton.html#gtk-tool-button-set-label-widget">gtk_tool_button_set_label_widget</a>    (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
119
                                                         <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *label_widget);
 
120
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkToolButton.html#gtk-tool-button-get-label-widget">gtk_tool_button_get_label_widget</a>    (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);
 
121
 
 
122
 
 
123
</pre>
 
124
</div>
 
125
<div class="refsect1" lang="en">
 
126
<a name="id3401821"></a><h2>Object Hierarchy</h2>
 
127
<pre class="synopsis">
 
128
 
 
129
  GObject
 
130
   +----GInitiallyUnowned
 
131
         +----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
 
132
               +----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
 
133
                     +----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
 
134
                           +----<a href="GtkBin.html" title="GtkBin">GtkBin</a>
 
135
                                 +----<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>
 
136
                                       +----GtkToolButton
 
137
                                             +----<a href="GtkMenuToolButton.html" title="GtkMenuToolButton">GtkMenuToolButton</a>
 
138
                                             +----<a href="GtkToggleToolButton.html" title="GtkToggleToolButton">GtkToggleToolButton</a>
 
139
</pre>
 
140
</div>
 
141
<div class="refsect1" lang="en">
 
142
<a name="id3401906"></a><h2>Implemented Interfaces</h2>
 
143
<p>
 
144
GtkToolButton implements
 
145
 AtkImplementorIface.</p>
 
146
</div>
 
147
<div class="refsect1" lang="en">
 
148
<a name="id3401929"></a><h2>Properties</h2>
 
149
<pre class="synopsis">
 
150
 
 
151
  "<a href="GtkToolButton.html#GtkToolButton--icon-name">icon-name</a>"                gchararray            : Read / Write
 
152
  "<a href="GtkToolButton.html#GtkToolButton--icon-widget">icon-widget</a>"              <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>             : Read / Write
 
153
  "<a href="GtkToolButton.html#GtkToolButton--label">label</a>"                    gchararray            : Read / Write
 
154
  "<a href="GtkToolButton.html#GtkToolButton--label-widget">label-widget</a>"             <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>             : Read / Write
 
155
  "<a href="GtkToolButton.html#GtkToolButton--stock-id">stock-id</a>"                 gchararray            : Read / Write
 
156
  "<a href="GtkToolButton.html#GtkToolButton--use-underline">use-underline</a>"            gboolean              : Read / Write
 
157
</pre>
 
158
</div>
 
159
<div class="refsect1" lang="en">
 
160
<a name="id3402050"></a><h2>Style Properties</h2>
 
161
<pre class="synopsis">
 
162
 
 
163
  "<a href="GtkToolButton.html#GtkToolButton--icon-spacing">icon-spacing</a>"             gint                  : Read / Write
 
164
</pre>
 
165
</div>
 
166
<div class="refsect1" lang="en">
 
167
<a name="id3402084"></a><h2>Signals</h2>
 
168
<pre class="synopsis">
 
169
 
 
170
  "<a href="GtkToolButton.html#GtkToolButton-clicked">clicked</a>"                                        : Run First / Action
 
171
</pre>
 
172
</div>
 
173
<div class="refsect1" lang="en">
 
174
<a name="id3402113"></a><h2>Description</h2>
 
175
<p>
 
176
<a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>s are <span class="type">GtkToolItems</span> containing buttons.
 
177
</p>
 
178
<p>
 
179
Use <a href="GtkToolButton.html#gtk-tool-button-new"><code class="function">gtk_tool_button_new()</code></a> to create a new <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>. Use
 
180
<code class="function">gtk_tool_button_new_with_stock()</code> to create a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
181
containing a stock item.
 
182
</p>
 
183
<p>
 
184
The label of a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> is determined by the properties
 
185
"label_widget", "label", and "stock_id". If "label_widget" is
 
186
non-<a
 
187
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
188
><code class="literal">NULL</code></a>, then that widget is used as the label. Otherwise, if
 
189
"label" is non-<a
 
190
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
191
><code class="literal">NULL</code></a>, that string is used as the label. Otherwise, if
 
192
"stock_id" is non-<a
 
193
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
194
><code class="literal">NULL</code></a>, the label is determined by the stock
 
195
item. Otherwise, the button does not have a label.
 
196
</p>
 
197
<p>
 
198
The icon of a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> is determined by the properties
 
199
"icon_widget" and "stock_id". If "icon_widget" is non-<a
 
200
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
201
><code class="literal">NULL</code></a>, then
 
202
that widget is used as the icon. Otherwise, if "stock_id" is
 
203
non-<a
 
204
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
205
><code class="literal">NULL</code></a>, the icon is determined by the stock item. Otherwise,
 
206
the button does not have a label.
 
207
</p>
 
208
</div>
 
209
<div class="refsect1" lang="en">
 
210
<a name="id3402273"></a><h2>Details</h2>
 
211
<div class="refsect2" lang="en">
 
212
<a name="id3402283"></a><h3>
 
213
<a name="GtkToolButton-struct"></a>GtkToolButton</h3>
 
214
<a class="indexterm" name="id3402296"></a><pre class="programlisting">typedef struct _GtkToolButton GtkToolButton;</pre>
 
215
<p>
 
216
The <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> struct contains only private. It should only be
 
217
accessed with the function described below.
 
218
</p>
 
219
</div>
 
220
<hr>
 
221
<div class="refsect2" lang="en">
 
222
<a name="id3402322"></a><h3>
 
223
<a name="gtk-tool-button-new"></a>gtk_tool_button_new ()</h3>
 
224
<a class="indexterm" name="id3402337"></a><pre class="programlisting"><a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>*        gtk_tool_button_new                 (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon_widget,
 
225
                                                         const gchar *label);</pre>
 
226
<p>
 
227
Creates a new <a href="GtkToolButton.html" title="GtkToolButton"><code class="literal">GtkToolButton</code></a> using <em class="parameter"><code>icon_widget</code></em> as icon and <em class="parameter"><code>label</code></em> as
 
228
label.</p>
 
229
<p>
 
230
 
 
231
</p>
 
232
<div class="variablelist"><table border="0">
 
233
<col align="left" valign="top">
 
234
<tbody>
 
235
<tr>
 
236
<td><span class="term"><em class="parameter"><code>icon_widget</code></em>&#160;:</span></td>
 
237
<td> a widget that will be used as icon widget, or <a
 
238
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
239
><code class="literal">NULL</code></a>
 
240
</td>
 
241
</tr>
 
242
<tr>
 
243
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
 
244
<td> a string that will be used as label, or <a
 
245
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
246
><code class="literal">NULL</code></a>
 
247
</td>
 
248
</tr>
 
249
<tr>
 
250
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
251
<td> A new <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
252
 
 
253
</td>
 
254
</tr>
 
255
</tbody>
 
256
</table></div>
 
257
<p class="since">Since  2.4
 
258
</p>
 
259
</div>
 
260
<hr>
 
261
<div class="refsect2" lang="en">
 
262
<a name="id3402477"></a><h3>
 
263
<a name="gtk-tool-button-new-from-stock"></a>gtk_tool_button_new_from_stock ()</h3>
 
264
<a class="indexterm" name="id3402493"></a><pre class="programlisting"><a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>*        gtk_tool_button_new_from_stock      (const gchar *stock_id);</pre>
 
265
<p>
 
266
Creates a new <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> containing the image and text from a
 
267
stock item. Some stock ids have preprocessor macros like <a href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS"><span class="type">GTK_STOCK_OK</span></a>
 
268
and <a href="gtk-Stock-Items.html#GTK-STOCK-APPLY:CAPS"><span class="type">GTK_STOCK_APPLY</span></a>.
 
269
</p>
 
270
<p>
 
271
It is an error if <em class="parameter"><code>stock_id</code></em> is not a name of a stock item.</p>
 
272
<p>
 
273
 
 
274
</p>
 
275
<div class="variablelist"><table border="0">
 
276
<col align="left" valign="top">
 
277
<tbody>
 
278
<tr>
 
279
<td><span class="term"><em class="parameter"><code>stock_id</code></em>&#160;:</span></td>
 
280
<td> the name of the stock item 
 
281
</td>
 
282
</tr>
 
283
<tr>
 
284
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
285
<td> A new <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
286
 
 
287
</td>
 
288
</tr>
 
289
</tbody>
 
290
</table></div>
 
291
<p class="since">Since  2.4
 
292
</p>
 
293
</div>
 
294
<hr>
 
295
<div class="refsect2" lang="en">
 
296
<a name="id3402607"></a><h3>
 
297
<a name="gtk-tool-button-set-label"></a>gtk_tool_button_set_label ()</h3>
 
298
<a class="indexterm" name="id3402622"></a><pre class="programlisting">void                gtk_tool_button_set_label           (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
299
                                                         const gchar *label);</pre>
 
300
<p>
 
301
Sets <em class="parameter"><code>label</code></em> as the label used for the tool button. The "label" property
 
302
only has an effect if not overridden by a non-<a
 
303
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
304
><code class="literal">NULL</code></a> "label_widget" property.
 
305
If both the "label_widget" and "label" properties are <a
 
306
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
307
><code class="literal">NULL</code></a>, the label
 
308
is determined by the "stock_id" property. If the "stock_id" property is also
 
309
<a
 
310
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
311
><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> will not have a label.</p>
 
312
<p>
 
313
 
 
314
</p>
 
315
<div class="variablelist"><table border="0">
 
316
<col align="left" valign="top">
 
317
<tbody>
 
318
<tr>
 
319
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
320
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
321
</td>
 
322
</tr>
 
323
<tr>
 
324
<td><span class="term"><em class="parameter"><code>label</code></em>&#160;:</span></td>
 
325
<td> a string that will be used as label, or <a
 
326
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
327
><code class="literal">NULL</code></a>.
 
328
</td>
 
329
</tr>
 
330
</tbody>
 
331
</table></div>
 
332
<p class="since">Since  2.4
 
333
</p>
 
334
</div>
 
335
<hr>
 
336
<div class="refsect2" lang="en">
 
337
<a name="id3402765"></a><h3>
 
338
<a name="gtk-tool-button-get-label"></a>gtk_tool_button_get_label ()</h3>
 
339
<a class="indexterm" name="id3402782"></a><pre class="programlisting">const gchar*        gtk_tool_button_get_label           (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</pre>
 
340
<p>
 
341
Returns the label used by the tool button, or <a
 
342
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
343
><code class="literal">NULL</code></a> if the tool button
 
344
doesn't have a label. or uses a the label from a stock item. The returned
 
345
string is owned by GTK+, and must not be modified or freed.</p>
 
346
<p>
 
347
 
 
348
</p>
 
349
<div class="variablelist"><table border="0">
 
350
<col align="left" valign="top">
 
351
<tbody>
 
352
<tr>
 
353
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
354
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
355
</td>
 
356
</tr>
 
357
<tr>
 
358
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
359
<td> The label, or <a
 
360
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
361
><code class="literal">NULL</code></a>
 
362
 
 
363
</td>
 
364
</tr>
 
365
</tbody>
 
366
</table></div>
 
367
<p class="since">Since  2.4
 
368
</p>
 
369
</div>
 
370
<hr>
 
371
<div class="refsect2" lang="en">
 
372
<a name="id3402881"></a><h3>
 
373
<a name="gtk-tool-button-set-use-underline"></a>gtk_tool_button_set_use_underline ()</h3>
 
374
<a class="indexterm" name="id3402898"></a><pre class="programlisting">void                gtk_tool_button_set_use_underline   (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
375
                                                         gboolean use_underline);</pre>
 
376
<p>
 
377
If set, an underline in the label property indicates that the next character
 
378
should be used for the mnemonic accelerator key in the overflow menu. For
 
379
example, if the label property is "_Open" and <em class="parameter"><code>use_underline</code></em> is <code class="literal">TRUE</code>,
 
380
the label on the tool button will be "Open" and the item on the overflow
 
381
menu will have an underlined 'O'.
 
382
</p>
 
383
<p>
 
384
Labels shown on tool buttons never have mnemonics on them; this property
 
385
only affects the menu item on the overflow menu.</p>
 
386
<p>
 
387
 
 
388
</p>
 
389
<div class="variablelist"><table border="0">
 
390
<col align="left" valign="top">
 
391
<tbody>
 
392
<tr>
 
393
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
394
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
395
</td>
 
396
</tr>
 
397
<tr>
 
398
<td><span class="term"><em class="parameter"><code>use_underline</code></em>&#160;:</span></td>
 
399
<td> whether the button label has the form "_Open"
 
400
</td>
 
401
</tr>
 
402
</tbody>
 
403
</table></div>
 
404
<p class="since">Since  2.4
 
405
</p>
 
406
</div>
 
407
<hr>
 
408
<div class="refsect2" lang="en">
 
409
<a name="id3403012"></a><h3>
 
410
<a name="gtk-tool-button-get-use-underline"></a>gtk_tool_button_get_use_underline ()</h3>
 
411
<a class="indexterm" name="id3403028"></a><pre class="programlisting">gboolean            gtk_tool_button_get_use_underline   (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</pre>
 
412
<p>
 
413
Returns whether underscores in the label property are used as mnemonics
 
414
on menu items on the overflow menu. See <a href="GtkToolButton.html#gtk-tool-button-set-use-underline"><code class="function">gtk_tool_button_set_use_underline()</code></a>.</p>
 
415
<p>
 
416
 
 
417
</p>
 
418
<div class="variablelist"><table border="0">
 
419
<col align="left" valign="top">
 
420
<tbody>
 
421
<tr>
 
422
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
423
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
424
</td>
 
425
</tr>
 
426
<tr>
 
427
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
428
<td> <code class="literal">TRUE</code> if underscores in the label property are used as
 
429
mnemonics on menu items on the overflow menu.
 
430
 
 
431
</td>
 
432
</tr>
 
433
</tbody>
 
434
</table></div>
 
435
<p class="since">Since  2.4
 
436
</p>
 
437
</div>
 
438
<hr>
 
439
<div class="refsect2" lang="en">
 
440
<a name="id3403127"></a><h3>
 
441
<a name="gtk-tool-button-set-stock-id"></a>gtk_tool_button_set_stock_id ()</h3>
 
442
<a class="indexterm" name="id3403143"></a><pre class="programlisting">void                gtk_tool_button_set_stock_id        (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
443
                                                         const gchar *stock_id);</pre>
 
444
<p>
 
445
Sets the name of the stock item. See <a href="GtkToolButton.html#gtk-tool-button-new-from-stock"><code class="function">gtk_tool_button_new_from_stock()</code></a>.
 
446
The stock_id property only has an effect if not
 
447
overridden by non-<a
 
448
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
449
><code class="literal">NULL</code></a> "label" and "icon_widget" properties.</p>
 
450
<p>
 
451
 
 
452
</p>
 
453
<div class="variablelist"><table border="0">
 
454
<col align="left" valign="top">
 
455
<tbody>
 
456
<tr>
 
457
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
458
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
459
</td>
 
460
</tr>
 
461
<tr>
 
462
<td><span class="term"><em class="parameter"><code>stock_id</code></em>&#160;:</span></td>
 
463
<td> a name of a stock item, or <a
 
464
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
465
><code class="literal">NULL</code></a>
 
466
</td>
 
467
</tr>
 
468
</tbody>
 
469
</table></div>
 
470
<p class="since">Since  2.4
 
471
</p>
 
472
</div>
 
473
<hr>
 
474
<div class="refsect2" lang="en">
 
475
<a name="id3403265"></a><h3>
 
476
<a name="gtk-tool-button-get-stock-id"></a>gtk_tool_button_get_stock_id ()</h3>
 
477
<a class="indexterm" name="id3403281"></a><pre class="programlisting">const gchar*        gtk_tool_button_get_stock_id        (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</pre>
 
478
<p>
 
479
Returns the name of the stock item. See <a href="GtkToolButton.html#gtk-tool-button-set-stock-id"><code class="function">gtk_tool_button_set_stock_id()</code></a>.
 
480
The returned string is owned by GTK+ and must not be freed or modifed.</p>
 
481
<p>
 
482
 
 
483
</p>
 
484
<div class="variablelist"><table border="0">
 
485
<col align="left" valign="top">
 
486
<tbody>
 
487
<tr>
 
488
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
489
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
490
</td>
 
491
</tr>
 
492
<tr>
 
493
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
494
<td> the name of the stock item for <em class="parameter"><code>button</code></em>.
 
495
 
 
496
</td>
 
497
</tr>
 
498
</tbody>
 
499
</table></div>
 
500
<p class="since">Since  2.4
 
501
</p>
 
502
</div>
 
503
<hr>
 
504
<div class="refsect2" lang="en">
 
505
<a name="id3403376"></a><h3>
 
506
<a name="gtk-tool-button-set-icon-name"></a>gtk_tool_button_set_icon_name ()</h3>
 
507
<a class="indexterm" name="id3403392"></a><pre class="programlisting">void                gtk_tool_button_set_icon_name       (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
508
                                                         const gchar *icon_name);</pre>
 
509
<p>
 
510
Sets the icon for the tool button from a named themed icon.
 
511
See the docs for <a href="GtkIconTheme.html" title="GtkIconTheme"><span class="type">GtkIconTheme</span></a> for more details.
 
512
The "icon_name" property only has an effect if not
 
513
overridden by non-<a
 
514
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
515
><code class="literal">NULL</code></a> "label", "icon_widget" and "stock_id"
 
516
properties.</p>
 
517
<p>
 
518
 
 
519
</p>
 
520
<div class="variablelist"><table border="0">
 
521
<col align="left" valign="top">
 
522
<tbody>
 
523
<tr>
 
524
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
525
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
526
</td>
 
527
</tr>
 
528
<tr>
 
529
<td><span class="term"><em class="parameter"><code>icon_name</code></em>&#160;:</span></td>
 
530
<td> the name of the themed icon
 
531
</td>
 
532
</tr>
 
533
</tbody>
 
534
</table></div>
 
535
<p class="since">Since  2.8
 
536
</p>
 
537
</div>
 
538
<hr>
 
539
<div class="refsect2" lang="en">
 
540
<a name="id3403501"></a><h3>
 
541
<a name="gtk-tool-button-get-icon-name"></a>gtk_tool_button_get_icon_name ()</h3>
 
542
<a class="indexterm" name="id3403517"></a><pre class="programlisting">const gchar*        gtk_tool_button_get_icon_name       (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</pre>
 
543
<p>
 
544
Returns the name of the themed icon for the tool button,
 
545
see <a href="GtkToolButton.html#gtk-tool-button-set-icon-name"><code class="function">gtk_tool_button_set_icon_name()</code></a>.</p>
 
546
<p>
 
547
 
 
548
</p>
 
549
<div class="variablelist"><table border="0">
 
550
<col align="left" valign="top">
 
551
<tbody>
 
552
<tr>
 
553
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
554
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
555
</td>
 
556
</tr>
 
557
<tr>
 
558
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
559
<td> the icon name or <a
 
560
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
561
><code class="literal">NULL</code></a> if the tool button has
 
562
no themed icon
 
563
 
 
564
</td>
 
565
</tr>
 
566
</tbody>
 
567
</table></div>
 
568
<p class="since">Since  2.8
 
569
</p>
 
570
</div>
 
571
<hr>
 
572
<div class="refsect2" lang="en">
 
573
<a name="id3403617"></a><h3>
 
574
<a name="gtk-tool-button-set-icon-widget"></a>gtk_tool_button_set_icon_widget ()</h3>
 
575
<a class="indexterm" name="id3403633"></a><pre class="programlisting">void                gtk_tool_button_set_icon_widget     (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
576
                                                         <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon_widget);</pre>
 
577
<p>
 
578
Sets <em class="parameter"><code>icon</code></em> as the widget used as icon on <em class="parameter"><code>button</code></em>. If <em class="parameter"><code>icon_widget</code></em> is
 
579
<a
 
580
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
581
><code class="literal">NULL</code></a> the icon is determined by the "stock_id" property. If the
 
582
"stock_id" property is also <a
 
583
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
584
><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> will not have an icon.</p>
 
585
<p>
 
586
 
 
587
</p>
 
588
<div class="variablelist"><table border="0">
 
589
<col align="left" valign="top">
 
590
<tbody>
 
591
<tr>
 
592
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
593
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
594
</td>
 
595
</tr>
 
596
<tr>
 
597
<td><span class="term"><em class="parameter"><code>icon_widget</code></em>&#160;:</span></td>
 
598
<td> the widget used as icon, or <a
 
599
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
600
><code class="literal">NULL</code></a>
 
601
</td>
 
602
</tr>
 
603
</tbody>
 
604
</table></div>
 
605
<p class="since">Since  2.4
 
606
</p>
 
607
</div>
 
608
<hr>
 
609
<div class="refsect2" lang="en">
 
610
<a name="id3403776"></a><h3>
 
611
<a name="gtk-tool-button-get-icon-widget"></a>gtk_tool_button_get_icon_widget ()</h3>
 
612
<a class="indexterm" name="id3403792"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_tool_button_get_icon_widget     (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</pre>
 
613
<p>
 
614
Return the widget used as icon widget on <em class="parameter"><code>button</code></em>. See
 
615
<a href="GtkToolButton.html#gtk-tool-button-set-icon-widget"><code class="function">gtk_tool_button_set_icon_widget()</code></a>.</p>
 
616
<p>
 
617
 
 
618
</p>
 
619
<div class="variablelist"><table border="0">
 
620
<col align="left" valign="top">
 
621
<tbody>
 
622
<tr>
 
623
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
624
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
625
</td>
 
626
</tr>
 
627
<tr>
 
628
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
629
<td> The widget used as icon on <em class="parameter"><code>button</code></em>, or <a
 
630
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
631
><code class="literal">NULL</code></a>.
 
632
 
 
633
</td>
 
634
</tr>
 
635
</tbody>
 
636
</table></div>
 
637
<p class="since">Since  2.4
 
638
</p>
 
639
</div>
 
640
<hr>
 
641
<div class="refsect2" lang="en">
 
642
<a name="id3403902"></a><h3>
 
643
<a name="gtk-tool-button-set-label-widget"></a>gtk_tool_button_set_label_widget ()</h3>
 
644
<a class="indexterm" name="id3403918"></a><pre class="programlisting">void                gtk_tool_button_set_label_widget    (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button,
 
645
                                                         <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *label_widget);</pre>
 
646
<p>
 
647
Sets <em class="parameter"><code>label_widget</code></em> as the widget that will be used as the label
 
648
for <em class="parameter"><code>button</code></em>. If <em class="parameter"><code>label_widget</code></em> is <a
 
649
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
650
><code class="literal">NULL</code></a> the "label" property is used
 
651
as label. If "label" is also <a
 
652
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
653
><code class="literal">NULL</code></a>, the label in the stock item
 
654
determined by the "stock_id" property is used as label. If
 
655
"stock_id" is also <a
 
656
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
657
><code class="literal">NULL</code></a>, <em class="parameter"><code>button</code></em> does not have a label.</p>
 
658
<p>
 
659
 
 
660
</p>
 
661
<div class="variablelist"><table border="0">
 
662
<col align="left" valign="top">
 
663
<tbody>
 
664
<tr>
 
665
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
666
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
667
</td>
 
668
</tr>
 
669
<tr>
 
670
<td><span class="term"><em class="parameter"><code>label_widget</code></em>&#160;:</span></td>
 
671
<td> the widget used as label, or <a
 
672
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
673
><code class="literal">NULL</code></a>
 
674
</td>
 
675
</tr>
 
676
</tbody>
 
677
</table></div>
 
678
<p class="since">Since  2.4
 
679
</p>
 
680
</div>
 
681
<hr>
 
682
<div class="refsect2" lang="en">
 
683
<a name="id3404073"></a><h3>
 
684
<a name="gtk-tool-button-get-label-widget"></a>gtk_tool_button_get_label_widget ()</h3>
 
685
<a class="indexterm" name="id3404089"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_tool_button_get_label_widget    (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *button);</pre>
 
686
<p>
 
687
Returns the widget used as label on <em class="parameter"><code>button</code></em>. See
 
688
<a href="GtkToolButton.html#gtk-tool-button-set-label-widget"><code class="function">gtk_tool_button_set_label_widget()</code></a>.</p>
 
689
<p>
 
690
 
 
691
</p>
 
692
<div class="variablelist"><table border="0">
 
693
<col align="left" valign="top">
 
694
<tbody>
 
695
<tr>
 
696
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
697
<td> a <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
 
698
</td>
 
699
</tr>
 
700
<tr>
 
701
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
702
<td> The widget used as label on <em class="parameter"><code>button</code></em>, or <a
 
703
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
 
704
><code class="literal">NULL</code></a>.
 
705
 
 
706
</td>
 
707
</tr>
 
708
</tbody>
 
709
</table></div>
 
710
<p class="since">Since  2.4
 
711
</p>
 
712
</div>
 
713
</div>
 
714
<div class="refsect1" lang="en">
 
715
<a name="id3404200"></a><h2>Property Details</h2>
 
716
<div class="refsect2" lang="en">
 
717
<a name="id3404211"></a><h3>
 
718
<a name="GtkToolButton--icon-name"></a>The "<code class="literal">icon-name</code>" property</h3>
 
719
<a class="indexterm" name="id3404227"></a><pre class="programlisting">  "icon-name"                gchararray            : Read / Write</pre>
 
720
<p>
 
721
The name of the themed icon displayed on the item.
 
722
This property only has an effect if not overridden by "label", 
 
723
"icon_widget" or "stock_id" properties.</p>
 
724
<p>
 
725
 
 
726
</p>
 
727
<p>Default value: NULL</p>
 
728
<p>Since  2.8 
 
729
</p>
 
730
</div>
 
731
<hr>
 
732
<div class="refsect2" lang="en">
 
733
<a name="id3404264"></a><h3>
 
734
<a name="GtkToolButton--icon-widget"></a>The "<code class="literal">icon-widget</code>" property</h3>
 
735
<a class="indexterm" name="id3404281"></a><pre class="programlisting">  "icon-widget"              <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>             : Read / Write</pre>
 
736
<p>Icon widget to display in the item.</p>
 
737
</div>
 
738
<hr>
 
739
<div class="refsect2" lang="en">
 
740
<a name="id3404304"></a><h3>
 
741
<a name="GtkToolButton--label"></a>The "<code class="literal">label</code>" property</h3>
 
742
<a class="indexterm" name="id3404320"></a><pre class="programlisting">  "label"                    gchararray            : Read / Write</pre>
 
743
<p>Text to show in the item.</p>
 
744
<p>Default value: NULL</p>
 
745
</div>
 
746
<hr>
 
747
<div class="refsect2" lang="en">
 
748
<a name="id3404347"></a><h3>
 
749
<a name="GtkToolButton--label-widget"></a>The "<code class="literal">label-widget</code>" property</h3>
 
750
<a class="indexterm" name="id3404364"></a><pre class="programlisting">  "label-widget"             <a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>             : Read / Write</pre>
 
751
<p>Widget to use as the item label.</p>
 
752
</div>
 
753
<hr>
 
754
<div class="refsect2" lang="en">
 
755
<a name="id3404387"></a><h3>
 
756
<a name="GtkToolButton--stock-id"></a>The "<code class="literal">stock-id</code>" property</h3>
 
757
<a class="indexterm" name="id3404404"></a><pre class="programlisting">  "stock-id"                 gchararray            : Read / Write</pre>
 
758
<p>The stock icon displayed on the item.</p>
 
759
<p>Default value: NULL</p>
 
760
</div>
 
761
<hr>
 
762
<div class="refsect2" lang="en">
 
763
<a name="id3404430"></a><h3>
 
764
<a name="GtkToolButton--use-underline"></a>The "<code class="literal">use-underline</code>" property</h3>
 
765
<a class="indexterm" name="id3404447"></a><pre class="programlisting">  "use-underline"            gboolean              : Read / Write</pre>
 
766
<p>If set, an underline in the label property indicates that the next character should be used for the mnemonic accelerator key in the overflow menu.</p>
 
767
<p>Default value: FALSE</p>
 
768
</div>
 
769
</div>
 
770
<div class="refsect1" lang="en">
 
771
<a name="id3404477"></a><h2>Style Property Details</h2>
 
772
<div class="refsect2" lang="en">
 
773
<a name="id3404488"></a><h3>
 
774
<a name="GtkToolButton--icon-spacing"></a>The "<code class="literal">icon-spacing</code>" style property</h3>
 
775
<a class="indexterm" name="id3404505"></a><pre class="programlisting">  "icon-spacing"             gint                  : Read / Write</pre>
 
776
<p>Spacing in pixels between the icon and label.</p>
 
777
<p>Allowed values: &gt;= 0</p>
 
778
<p>Default value: 0</p>
 
779
</div>
 
780
</div>
 
781
<div class="refsect1" lang="en">
 
782
<a name="id3404536"></a><h2>Signal Details</h2>
 
783
<div class="refsect2" lang="en">
 
784
<a name="id3404547"></a><h3>
 
785
<a name="GtkToolButton-clicked"></a>The "clicked" signal</h3>
 
786
<a class="indexterm" name="id3404558"></a><pre class="programlisting">void                user_function                      (<a href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a> *toolbutton,
 
787
                                                        gpointer       user_data)       : Run First / Action</pre>
 
788
<p>
 
789
This signal is emitted when the tool button is clicked with the mouse
 
790
or activated with the keyboard.</p>
 
791
<p>
 
792
 
 
793
</p>
 
794
<div class="variablelist"><table border="0">
 
795
<col align="left" valign="top">
 
796
<tbody>
 
797
<tr>
 
798
<td><span class="term"><em class="parameter"><code>toolbutton</code></em>&#160;:</span></td>
 
799
<td> the object that emitted the signal
 
800
</td>
 
801
</tr>
 
802
<tr>
 
803
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
804
<td>user data set when the signal handler was connected.</td>
 
805
</tr>
 
806
</tbody>
 
807
</table></div>
 
808
</div>
 
809
</div>
 
810
<div class="refsect1" lang="en">
 
811
<a name="id3404634"></a><h2>See Also</h2>
 
812
<p>
 
813
</p>
 
814
<div class="variablelist"><table border="0">
 
815
<col align="left" valign="top">
 
816
<tbody>
 
817
<tr>
 
818
<td><span class="term"><a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a></span></td>
 
819
<td><p>The toolbar widget</p></td>
 
820
</tr>
 
821
<tr>
 
822
<td><span class="term"><a href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a></span></td>
 
823
<td><p>A subclass of <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> that displays on 
 
824
    the toolbar a button with an additional dropdown
 
825
    menu</p></td>
 
826
</tr>
 
827
<tr>
 
828
<td><span class="term"><a href="GtkToggleToolButton.html" title="GtkToggleToolButton"><span class="type">GtkToggleToolButton</span></a></span></td>
 
829
<td><p>A subclass of <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> that displays toggle
 
830
    buttons on the toolbar</p></td>
 
831
</tr>
 
832
<tr>
 
833
<td><span class="term"><a href="GtkRadioToolButton.html" title="GtkRadioToolButton"><span class="type">GtkRadioToolButton</span></a></span></td>
 
834
<td><p>A subclass of <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a> that displays radio
 
835
    buttons on the toolbar</p></td>
 
836
</tr>
 
837
<tr>
 
838
<td><span class="term"><a href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a></span></td>
 
839
<td><p>A subclass of <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> that separates groups of
 
840
    items on a toolbar</p></td>
 
841
</tr>
 
842
</tbody>
 
843
</table></div>
 
844
<p>
 
845
</p>
 
846
</div>
 
847
</div>
 
848
</body>
 
849
</html>