docs/reference/gtk/html/GtkToolbar.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=UTF-8">
   5 <title>GtkToolbar</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
   8 <link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
   9 <link rel="prev" href="GtkToolShell.html" title="GtkToolShell">
  10 <link rel="next" href="GtkToolItem.html" title="GtkToolItem">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="GtkToolShell.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GTK+ 3 Reference Manual</th>
  21 <td><a accesskey="n" href="GtkToolItem.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#GtkToolbar.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GtkToolbar.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GtkToolbar.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#GtkToolbar.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31                    |
  32                   <a href="#GtkToolbar.properties" class="shortcut">Properties</a>
  33                    |
  34                   <a href="#GtkToolbar.child-properties" class="shortcut">Child Properties</a>
  35                    |
  36                   <a href="#GtkToolbar.style-properties" class="shortcut">Style Properties</a>
  37                    |
  38                   <a href="#GtkToolbar.signals" class="shortcut">Signals</a>
  39 </td></tr>
  40 </table>
  41 <div class="refentry">
  42 <a name="GtkToolbar"></a><div class="titlepage"></div>
  43 <div class="refnamediv"><table width="100%"><tr>
  44 <td valign="top">
  45 <h2><span class="refentrytitle"><a name="GtkToolbar.top_of_page"></a>GtkToolbar</span></h2>
  46 <p>GtkToolbar — Create bars of buttons and other widgets</p>
  47 </td>
  48 <td valign="top" align="right"><img src="toolbar.png"></td>
  49 </tr></table></div>
  50 <div class="refsynopsisdiv">
  51 <a name="GtkToolbar.synopsis"></a><h2>Synopsis</h2>
  52 <pre class="synopsis">
  53 #include &lt;gtk/gtk.h&gt;
  54
  55 struct              <a class="link" href="GtkToolbar.html#GtkToolbar-struct" title="struct GtkToolbar">GtkToolbar</a>;
  56 enum                <a class="link" href="GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</a>;
  57 <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkToolbar.html#gtk-toolbar-new" title="gtk_toolbar_new ()">gtk_toolbar_new</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
  58 <span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()">gtk_toolbar_insert</a>                  (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  59                                                          <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>,
  60                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>);
  61 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkToolbar.html#gtk-toolbar-get-item-index" title="gtk_toolbar_get_item_index ()">gtk_toolbar_get_item_index</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  62                                                          <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>);
  63 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkToolbar.html#gtk-toolbar-get-n-items" title="gtk_toolbar_get_n_items ()">gtk_toolbar_get_n_items</a>             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
  64 <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="GtkToolbar.html#gtk-toolbar-get-nth-item" title="gtk_toolbar_get_nth_item ()">gtk_toolbar_get_nth_item</a>            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  65                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);
  66 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkToolbar.html#gtk-toolbar-get-drop-index" title="gtk_toolbar_get_drop_index ()">gtk_toolbar_get_drop_index</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  67                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
  68                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
  69 <span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-drop-highlight-item" title="gtk_toolbar_set_drop_highlight_item ()">gtk_toolbar_set_drop_highlight_item</a> (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  70                                                          <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
  71                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);
  72 <span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-show-arrow" title="gtk_toolbar_set_show_arrow ()">gtk_toolbar_set_show_arrow</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  73                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_arrow</code></em>);
  74 <span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-unset-icon-size" title="gtk_toolbar_unset_icon_size ()">gtk_toolbar_unset_icon_size</a>         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
  75 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkToolbar.html#gtk-toolbar-get-show-arrow" title="gtk_toolbar_get_show_arrow ()">gtk_toolbar_get_show_arrow</a>          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
  76 <a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>     <a class="link" href="GtkToolbar.html#gtk-toolbar-get-style" title="gtk_toolbar_get_style ()">gtk_toolbar_get_style</a>               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
  77 <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         <a class="link" href="GtkToolbar.html#gtk-toolbar-get-icon-size" title="gtk_toolbar_get_icon_size ()">gtk_toolbar_get_icon_size</a>           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
  78 <a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>      <a class="link" href="GtkToolbar.html#gtk-toolbar-get-relief-style" title="gtk_toolbar_get_relief_style ()">gtk_toolbar_get_relief_style</a>        (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
  79 <span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()">gtk_toolbar_set_style</a>               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  80                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style</code></em>);
  81 <span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()">gtk_toolbar_set_icon_size</a>           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
  82                                                          <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);
  83 <span class="returnvalue">void</span>                <a class="link" href="GtkToolbar.html#gtk-toolbar-unset-style" title="gtk_toolbar_unset_style ()">gtk_toolbar_unset_style</a>             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);
  84 </pre>
  85 </div>
  86 <div class="refsect1">
  87 <a name="GtkToolbar.object-hierarchy"></a><h2>Object Hierarchy</h2>
  88 <pre class="synopsis">
  89   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  90    +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
  91          +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
  92                +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
  93                      +----GtkToolbar
  94 </pre>
  95 </div>
  96 <div class="refsect1">
  97 <a name="GtkToolbar.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
  98 <p>
  99 GtkToolbar implements
 100  AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>,  <a class="link" href="GtkToolShell.html" title="GtkToolShell">GtkToolShell</a> and  <a class="link" href="gtk3-Orientable.html#GtkOrientable">GtkOrientable</a>.</p>
 101 </div>
 102 <div class="refsect1">
 103 <a name="GtkToolbar.properties"></a><h2>Properties</h2>
 104 <pre class="synopsis">
 105   "<a class="link" href="GtkToolbar.html#GtkToolbar--icon-size" title='The "icon-size" property'>icon-size</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 106   "<a class="link" href="GtkToolbar.html#GtkToolbar--icon-size-set" title='The "icon-size-set" property'>icon-size-set</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 107   "<a class="link" href="GtkToolbar.html#GtkToolbar--show-arrow" title='The "show-arrow" property'>show-arrow</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 108   "<a class="link" href="GtkToolbar.html#GtkToolbar--toolbar-style" title='The "toolbar-style" property'>toolbar-style</a>"            <a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a>       : Read / Write
 109 </pre>
 110 </div>
 111 <div class="refsect1">
 112 <a name="GtkToolbar.child-properties"></a><h2>Child Properties</h2>
 113 <pre class="synopsis">
 114   "<a class="link" href="GtkToolbar.html#GtkToolbar--c-expand" title='The "expand" child property'>expand</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 115   "<a class="link" href="GtkToolbar.html#GtkToolbar--c-homogeneous" title='The "homogeneous" child property'>homogeneous</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 116 </pre>
 117 </div>
 118 <div class="refsect1">
 119 <a name="GtkToolbar.style-properties"></a><h2>Style Properties</h2>
 120 <pre class="synopsis">
 121   "<a class="link" href="GtkToolbar.html#GtkToolbar--s-button-relief" title='The "button-relief" style property'>button-relief</a>"            <a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="type">GtkReliefStyle</span></a>        : Read
 122   "<a class="link" href="GtkToolbar.html#GtkToolbar--s-internal-padding" title='The "internal-padding" style property'>internal-padding</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 123   "<a class="link" href="GtkToolbar.html#GtkToolbar--s-max-child-expand" title='The "max-child-expand" style property'>max-child-expand</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 124   "<a class="link" href="GtkToolbar.html#GtkToolbar--s-shadow-type" title='The "shadow-type" style property'>shadow-type</a>"              <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read
 125   "<a class="link" href="GtkToolbar.html#GtkToolbar--s-space-size" title='The "space-size" style property'>space-size</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 126   "<a class="link" href="GtkToolbar.html#GtkToolbar--s-space-style" title='The "space-style" style property'>space-style</a>"              <a class="link" href="GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle"><span class="type">GtkToolbarSpaceStyle</span></a>  : Read
 127 </pre>
 128 </div>
 129 <div class="refsect1">
 130 <a name="GtkToolbar.signals"></a><h2>Signals</h2>
 131 <pre class="synopsis">
 132   "<a class="link" href="GtkToolbar.html#GtkToolbar-focus-home-or-end" title='The "focus-home-or-end" signal'>focus-home-or-end</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
 133   "<a class="link" href="GtkToolbar.html#GtkToolbar-orientation-changed" title='The "orientation-changed" signal'>orientation-changed</a>"                            : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
 134   "<a class="link" href="GtkToolbar.html#GtkToolbar-popup-context-menu" title='The "popup-context-menu" signal'>popup-context-menu</a>"                             : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 135   "<a class="link" href="GtkToolbar.html#GtkToolbar-style-changed" title='The "style-changed" signal'>style-changed</a>"                                  : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
 136 </pre>
 137 </div>
 138 <div class="refsect1">
 139 <a name="GtkToolbar.description"></a><h2>Description</h2>
 140 <p>
 141 A toolbar is created with a call to <a class="link" href="GtkToolbar.html#gtk-toolbar-new" title="gtk_toolbar_new ()"><code class="function">gtk_toolbar_new()</code></a>.
 142 </p>
 143 <p>
 144 A toolbar can contain instances of a subclass of <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>. To add
 145 a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> to the a toolbar, use <a class="link" href="GtkToolbar.html#gtk-toolbar-insert" title="gtk_toolbar_insert ()"><code class="function">gtk_toolbar_insert()</code></a>. To remove
 146 an item from the toolbar use <a class="link" href="GtkContainer.html#gtk-container-remove" title="gtk_container_remove ()"><code class="function">gtk_container_remove()</code></a>. To add a button
 147 to the toolbar, add an instance of <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>.
 148 </p>
 149 <p>
 150 Toolbar items can be visually grouped by adding instances of
 151 <a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a> to the toolbar. If the GtkToolbar child property
 152 "expand" is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> and the property <a class="link" href="GtkSeparatorToolItem.html#GtkSeparatorToolItem--draw" title='The "draw" property'><span class="type">"draw"</span></a> is set to
 153 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>, the effect is to force all following items to the end of the toolbar.
 154 </p>
 155 <p>
 156 Creating a context menu for the toolbar can be done by connecting to
 157 the <a class="link" href="GtkToolbar.html#GtkToolbar-popup-context-menu" title='The "popup-context-menu" signal'><span class="type">"popup-context-menu"</span></a> signal.
 158 </p>
 159 </div>
 160 <div class="refsect1">
 161 <a name="GtkToolbar.details"></a><h2>Details</h2>
 162 <div class="refsect2">
 163 <a name="GtkToolbar-struct"></a><h3>struct GtkToolbar</h3>
 164 <pre class="programlisting">struct GtkToolbar;</pre>
 165 </div>
 166 <hr>
 167 <div class="refsect2">
 168 <a name="GtkToolbarSpaceStyle"></a><h3>enum GtkToolbarSpaceStyle</h3>
 169 <pre class="programlisting">typedef enum {
 170   GTK_TOOLBAR_SPACE_EMPTY,
 171   GTK_TOOLBAR_SPACE_LINE
 172 } GtkToolbarSpaceStyle;
 173 </pre>
 174 </div>
 175 <hr>
 176 <div class="refsect2">
 177 <a name="gtk-toolbar-new"></a><h3>gtk_toolbar_new ()</h3>
 178 <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_toolbar_new                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 179 <p>
 180 Creates a new toolbar.
 181 </p>
 182 <div class="variablelist"><table border="0">
 183 <col align="left" valign="top">
 184 <tbody><tr>
 185 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 186 <td>the newly-created toolbar.</td>
 187 </tr></tbody>
 188 </table></div>
 189 </div>
 190 <hr>
 191 <div class="refsect2">
 192 <a name="gtk-toolbar-insert"></a><h3>gtk_toolbar_insert ()</h3>
 193 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_insert                  (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 194                                                          <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>,
 195                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> pos</code></em>);</pre>
 196 <p>
 197 Insert a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> into the toolbar at position <em class="parameter"><code>pos</code></em>. If <em class="parameter"><code>pos</code></em> is
 198 0 the item is prepended to the start of the toolbar. If <em class="parameter"><code>pos</code></em> is
 199 negative, the item is appended to the end of the toolbar.
 200 </p>
 201 <div class="variablelist"><table border="0">
 202 <col align="left" valign="top">
 203 <tbody>
 204 <tr>
 205 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 206 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 207 </td>
 208 </tr>
 209 <tr>
 210 <td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
 211 <td>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
 212 </td>
 213 </tr>
 214 <tr>
 215 <td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
 216 <td>the position of the new item</td>
 217 </tr>
 218 </tbody>
 219 </table></div>
 220 <p class="since">Since 2.4</p>
 221 </div>
 222 <hr>
 223 <div class="refsect2">
 224 <a name="gtk-toolbar-get-item-index"></a><h3>gtk_toolbar_get_item_index ()</h3>
 225 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_item_index          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 226                                                          <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *item</code></em>);</pre>
 227 <p>
 228 Returns the position of <em class="parameter"><code>item</code></em> on the toolbar, starting from 0.
 229 It is an error if <em class="parameter"><code>item</code></em> is not a child of the toolbar.
 230 </p>
 231 <div class="variablelist"><table border="0">
 232 <col align="left" valign="top">
 233 <tbody>
 234 <tr>
 235 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 236 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 237 </td>
 238 </tr>
 239 <tr>
 240 <td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
 241 <td>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> that is a child of <em class="parameter"><code>toolbar</code></em>
 242 </td>
 243 </tr>
 244 <tr>
 245 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 246 <td>the position of item on the toolbar.</td>
 247 </tr>
 248 </tbody>
 249 </table></div>
 250 <p class="since">Since 2.4</p>
 251 </div>
 252 <hr>
 253 <div class="refsect2">
 254 <a name="gtk-toolbar-get-n-items"></a><h3>gtk_toolbar_get_n_items ()</h3>
 255 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_n_items             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
 256 <p>
 257 Returns the number of items on the toolbar.
 258 </p>
 259 <div class="variablelist"><table border="0">
 260 <col align="left" valign="top">
 261 <tbody>
 262 <tr>
 263 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 264 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 265 </td>
 266 </tr>
 267 <tr>
 268 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 269 <td>the number of items on the toolbar</td>
 270 </tr>
 271 </tbody>
 272 </table></div>
 273 <p class="since">Since 2.4</p>
 274 </div>
 275 <hr>
 276 <div class="refsect2">
 277 <a name="gtk-toolbar-get-nth-item"></a><h3>gtk_toolbar_get_nth_item ()</h3>
 278 <pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_toolbar_get_nth_item            (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 279                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);</pre>
 280 <p>
 281 Returns the <em class="parameter"><code>n</code></em>'th item on <em class="parameter"><code>toolbar</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the
 282 toolbar does not contain an <em class="parameter"><code>n</code></em>'th item.
 283 </p>
 284 <div class="variablelist"><table border="0">
 285 <col align="left" valign="top">
 286 <tbody>
 287 <tr>
 288 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 289 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 290 </td>
 291 </tr>
 292 <tr>
 293 <td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
 294 <td>A position on the toolbar</td>
 295 </tr>
 296 <tr>
 297 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 298 <td>The <em class="parameter"><code>n</code></em>'th <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> on <em class="parameter"><code>toolbar</code></em>,
 299 or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there isn't an <em class="parameter"><code>n</code></em>'th item. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 300 </td>
 301 </tr>
 302 </tbody>
 303 </table></div>
 304 <p class="since">Since 2.4</p>
 305 </div>
 306 <hr>
 307 <div class="refsect2">
 308 <a name="gtk-toolbar-get-drop-index"></a><h3>gtk_toolbar_get_drop_index ()</h3>
 309 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_toolbar_get_drop_index          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 310                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
 311                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
 312 <p>
 313 Returns the position corresponding to the indicated point on
 314 <em class="parameter"><code>toolbar</code></em>. This is useful when dragging items to the toolbar:
 315 this function returns the position a new item should be
 316 inserted.
 317 </p>
 318 <p>
 319 <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> are in <em class="parameter"><code>toolbar</code></em> coordinates.
 320 </p>
 321 <div class="variablelist"><table border="0">
 322 <col align="left" valign="top">
 323 <tbody>
 324 <tr>
 325 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 326 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 327 </td>
 328 </tr>
 329 <tr>
 330 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
 331 <td>x coordinate of a point on the toolbar</td>
 332 </tr>
 333 <tr>
 334 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
 335 <td>y coordinate of a point on the toolbar</td>
 336 </tr>
 337 <tr>
 338 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 339 <td>The position corresponding to the point (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>) on the toolbar.</td>
 340 </tr>
 341 </tbody>
 342 </table></div>
 343 <p class="since">Since 2.4</p>
 344 </div>
 345 <hr>
 346 <div class="refsect2">
 347 <a name="gtk-toolbar-set-drop-highlight-item"></a><h3>gtk_toolbar_set_drop_highlight_item ()</h3>
 348 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_drop_highlight_item (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 349                                                          <em class="parameter"><code><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> *tool_item</code></em>,
 350                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index_</code></em>);</pre>
 351 <p>
 352 Highlights <em class="parameter"><code>toolbar</code></em> to give an idea of what it would look like
 353 if <em class="parameter"><code>item</code></em> was added to <em class="parameter"><code>toolbar</code></em> at the position indicated by <em class="parameter"><code>index_</code></em>.
 354 If <em class="parameter"><code>item</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, highlighting is turned off. In that case <em class="parameter"><code>index_</code></em>
 355 is ignored.
 356 </p>
 357 <p>
 358 The <em class="parameter"><code>tool_item</code></em> passed to this function must not be part of any widget
 359 hierarchy. When an item is set as drop highlight item it can not
 360 added to any widget hierarchy or used as highlight item for another
 361 toolbar.
 362 </p>
 363 <div class="variablelist"><table border="0">
 364 <col align="left" valign="top">
 365 <tbody>
 366 <tr>
 367 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 368 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 369 </td>
 370 </tr>
 371 <tr>
 372 <td><p><span class="term"><em class="parameter"><code>tool_item</code></em> :</span></p></td>
 373 <td>a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to turn of highlighting. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 374 </td>
 375 </tr>
 376 <tr>
 377 <td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
 378 <td>a position on <em class="parameter"><code>toolbar</code></em>
 379 </td>
 380 </tr>
 381 </tbody>
 382 </table></div>
 383 <p class="since">Since 2.4</p>
 384 </div>
 385 <hr>
 386 <div class="refsect2">
 387 <a name="gtk-toolbar-set-show-arrow"></a><h3>gtk_toolbar_set_show_arrow ()</h3>
 388 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_show_arrow          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 389                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_arrow</code></em>);</pre>
 390 <p>
 391 Sets whether to show an overflow menu when
 392 <em class="parameter"><code>toolbar</code></em> doesn't have room for all items on it. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>,
 393 items that there are not room are available through an
 394 overflow menu.
 395 </p>
 396 <div class="variablelist"><table border="0">
 397 <col align="left" valign="top">
 398 <tbody>
 399 <tr>
 400 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 401 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 402 </td>
 403 </tr>
 404 <tr>
 405 <td><p><span class="term"><em class="parameter"><code>show_arrow</code></em> :</span></p></td>
 406 <td>Whether to show an overflow menu</td>
 407 </tr>
 408 </tbody>
 409 </table></div>
 410 <p class="since">Since 2.4</p>
 411 </div>
 412 <hr>
 413 <div class="refsect2">
 414 <a name="gtk-toolbar-unset-icon-size"></a><h3>gtk_toolbar_unset_icon_size ()</h3>
 415 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_unset_icon_size         (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
 416 <p>
 417 Unsets toolbar icon size set with <a class="link" href="GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()"><code class="function">gtk_toolbar_set_icon_size()</code></a>, so that
 418 user preferences will be used to determine the icon size.
 419 </p>
 420 <div class="variablelist"><table border="0">
 421 <col align="left" valign="top">
 422 <tbody><tr>
 423 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 424 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 425 </td>
 426 </tr></tbody>
 427 </table></div>
 428 </div>
 429 <hr>
 430 <div class="refsect2">
 431 <a name="gtk-toolbar-get-show-arrow"></a><h3>gtk_toolbar_get_show_arrow ()</h3>
 432 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_toolbar_get_show_arrow          (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
 433 <p>
 434 Returns whether the toolbar has an overflow menu.
 435 See <a class="link" href="GtkToolbar.html#gtk-toolbar-set-show-arrow" title="gtk_toolbar_set_show_arrow ()"><code class="function">gtk_toolbar_set_show_arrow()</code></a>.
 436 </p>
 437 <div class="variablelist"><table border="0">
 438 <col align="left" valign="top">
 439 <tbody>
 440 <tr>
 441 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 442 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 443 </td>
 444 </tr>
 445 <tr>
 446 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 447 <td>
 448 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the toolbar has an overflow menu.</td>
 449 </tr>
 450 </tbody>
 451 </table></div>
 452 <p class="since">Since 2.4</p>
 453 </div>
 454 <hr>
 455 <div class="refsect2">
 456 <a name="gtk-toolbar-get-style"></a><h3>gtk_toolbar_get_style ()</h3>
 457 <pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="returnvalue">GtkToolbarStyle</span></a>     gtk_toolbar_get_style               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
 458 <p>
 459 Retrieves whether the toolbar has text, icons, or both . See
 460 <a class="link" href="GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()"><code class="function">gtk_toolbar_set_style()</code></a>.
 461 </p>
 462 <div class="variablelist"><table border="0">
 463 <col align="left" valign="top">
 464 <tbody>
 465 <tr>
 466 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 467 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 468 </td>
 469 </tr>
 470 <tr>
 471 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 472 <td>the current style of <em class="parameter"><code>toolbar</code></em>
 473 </td>
 474 </tr>
 475 </tbody>
 476 </table></div>
 477 </div>
 478 <hr>
 479 <div class="refsect2">
 480 <a name="gtk-toolbar-get-icon-size"></a><h3>gtk_toolbar_get_icon_size ()</h3>
 481 <pre class="programlisting"><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="returnvalue">GtkIconSize</span></a>         gtk_toolbar_get_icon_size           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
 482 <p>
 483 Retrieves the icon size for the toolbar. See <a class="link" href="GtkToolbar.html#gtk-toolbar-set-icon-size" title="gtk_toolbar_set_icon_size ()"><code class="function">gtk_toolbar_set_icon_size()</code></a>.
 484 </p>
 485 <div class="variablelist"><table border="0">
 486 <col align="left" valign="top">
 487 <tbody>
 488 <tr>
 489 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 490 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 491 </td>
 492 </tr>
 493 <tr>
 494 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 495 <td>the current icon size for the icons on
 496 the toolbar. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> int]</span>
 497 </td>
 498 </tr>
 499 </tbody>
 500 </table></div>
 501 </div>
 502 <hr>
 503 <div class="refsect2">
 504 <a name="gtk-toolbar-get-relief-style"></a><h3>gtk_toolbar_get_relief_style ()</h3>
 505 <pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="returnvalue">GtkReliefStyle</span></a>      gtk_toolbar_get_relief_style        (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
 506 <p>
 507 Returns the relief style of buttons on <em class="parameter"><code>toolbar</code></em>. See
 508 <a class="link" href="GtkButton.html#gtk-button-set-relief" title="gtk_button_set_relief ()"><code class="function">gtk_button_set_relief()</code></a>.
 509 </p>
 510 <div class="variablelist"><table border="0">
 511 <col align="left" valign="top">
 512 <tbody>
 513 <tr>
 514 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 515 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 516 </td>
 517 </tr>
 518 <tr>
 519 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 520 <td>The relief style of buttons on <em class="parameter"><code>toolbar</code></em>.</td>
 521 </tr>
 522 </tbody>
 523 </table></div>
 524 <p class="since">Since 2.4</p>
 525 </div>
 526 <hr>
 527 <div class="refsect2">
 528 <a name="gtk-toolbar-set-style"></a><h3>gtk_toolbar_set_style ()</h3>
 529 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_style               (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 530                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style</code></em>);</pre>
 531 <p>
 532 Alters the view of <em class="parameter"><code>toolbar</code></em> to display either icons only, text only, or both.
 533 </p>
 534 <div class="variablelist"><table border="0">
 535 <col align="left" valign="top">
 536 <tbody>
 537 <tr>
 538 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 539 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.</td>
 540 </tr>
 541 <tr>
 542 <td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
 543 <td>the new style for <em class="parameter"><code>toolbar</code></em>.</td>
 544 </tr>
 545 </tbody>
 546 </table></div>
 547 </div>
 548 <hr>
 549 <div class="refsect2">
 550 <a name="gtk-toolbar-set-icon-size"></a><h3>gtk_toolbar_set_icon_size ()</h3>
 551 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_set_icon_size           (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>,
 552                                                          <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
 553 <p>
 554 This function sets the size of stock icons in the toolbar. You
 555 can call it both before you add the icons and after they've been
 556 added. The size you set will override user preferences for the default
 557 icon size.
 558 </p>
 559 <p>
 560 This should only be used for special-purpose toolbars, normal
 561 application toolbars should respect the user preferences for the
 562 size of icons.
 563 </p>
 564 <div class="variablelist"><table border="0">
 565 <col align="left" valign="top">
 566 <tbody>
 567 <tr>
 568 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 569 <td>A <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 570 </td>
 571 </tr>
 572 <tr>
 573 <td><p><span class="term"><em class="parameter"><code>icon_size</code></em> :</span></p></td>
 574 <td>The <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> that stock icons in the
 575 toolbar shall have. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> int]</span>
 576 </td>
 577 </tr>
 578 </tbody>
 579 </table></div>
 580 </div>
 581 <hr>
 582 <div class="refsect2">
 583 <a name="gtk-toolbar-unset-style"></a><h3>gtk_toolbar_unset_style ()</h3>
 584 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_toolbar_unset_style             (<em class="parameter"><code><a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar</code></em>);</pre>
 585 <p>
 586 Unsets a toolbar style set with <a class="link" href="GtkToolbar.html#gtk-toolbar-set-style" title="gtk_toolbar_set_style ()"><code class="function">gtk_toolbar_set_style()</code></a>, so that
 587 user preferences will be used to determine the toolbar style.
 588 </p>
 589 <div class="variablelist"><table border="0">
 590 <col align="left" valign="top">
 591 <tbody><tr>
 592 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 593 <td>a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
 594 </td>
 595 </tr></tbody>
 596 </table></div>
 597 </div>
 598 </div>
 599 <div class="refsect1">
 600 <a name="GtkToolbar.property-details"></a><h2>Property Details</h2>
 601 <div class="refsect2">
 602 <a name="GtkToolbar--icon-size"></a><h3>The <code class="literal">"icon-size"</code> property</h3>
 603 <pre class="programlisting">  "icon-size"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 604 <p>
 605 The size of the icons in a toolbar is normally determined by
 606 the toolbar-icon-size setting. When this property is set, it
 607 overrides the setting.
 608 </p>
 609 <p>
 610 This should only be used for special-purpose toolbars, normal
 611 application toolbars should respect the user preferences for the
 612 size of icons.
 613 </p>
 614 <p>Allowed values: &gt;= 0</p>
 615 <p>Default value: 3</p>
 616 <p class="since">Since 2.10</p>
 617 </div>
 618 <hr>
 619 <div class="refsect2">
 620 <a name="GtkToolbar--icon-size-set"></a><h3>The <code class="literal">"icon-size-set"</code> property</h3>
 621 <pre class="programlisting">  "icon-size-set"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 622 <p>
 623 Is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the icon-size property has been set.
 624 </p>
 625 <p>Default value: FALSE</p>
 626 <p class="since">Since 2.10</p>
 627 </div>
 628 <hr>
 629 <div class="refsect2">
 630 <a name="GtkToolbar--show-arrow"></a><h3>The <code class="literal">"show-arrow"</code> property</h3>
 631 <pre class="programlisting">  "show-arrow"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 632 <p>If an arrow should be shown if the toolbar doesn't fit.</p>
 633 <p>Default value: TRUE</p>
 634 </div>
 635 <hr>
 636 <div class="refsect2">
 637 <a name="GtkToolbar--toolbar-style"></a><h3>The <code class="literal">"toolbar-style"</code> property</h3>
 638 <pre class="programlisting">  "toolbar-style"            <a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a>       : Read / Write</pre>
 639 <p>How to draw the toolbar.</p>
 640 <p>Default value: GTK_TOOLBAR_BOTH</p>
 641 </div>
 642 </div>
 643 <div class="refsect1">
 644 <a name="GtkToolbar.child-property-details"></a><h2>Child Property Details</h2>
 645 <div class="refsect2">
 646 <a name="GtkToolbar--c-expand"></a><h3>The <code class="literal">"expand"</code> child property</h3>
 647 <pre class="programlisting">  "expand"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 648 <p>Whether the item should receive extra space when the toolbar grows.</p>
 649 <p>Default value: FALSE</p>
 650 </div>
 651 <hr>
 652 <div class="refsect2">
 653 <a name="GtkToolbar--c-homogeneous"></a><h3>The <code class="literal">"homogeneous"</code> child property</h3>
 654 <pre class="programlisting">  "homogeneous"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 655 <p>Whether the item should be the same size as other homogeneous items.</p>
 656 <p>Default value: FALSE</p>
 657 </div>
 658 </div>
 659 <div class="refsect1">
 660 <a name="GtkToolbar.style-property-details"></a><h2>Style Property Details</h2>
 661 <div class="refsect2">
 662 <a name="GtkToolbar--s-button-relief"></a><h3>The <code class="literal">"button-relief"</code> style property</h3>
 663 <pre class="programlisting">  "button-relief"            <a class="link" href="gtk3-Standard-Enumerations.html#GtkReliefStyle" title="enum GtkReliefStyle"><span class="type">GtkReliefStyle</span></a>        : Read</pre>
 664 <p>Type of bevel around toolbar buttons.</p>
 665 <p>Default value: GTK_RELIEF_NONE</p>
 666 </div>
 667 <hr>
 668 <div class="refsect2">
 669 <a name="GtkToolbar--s-internal-padding"></a><h3>The <code class="literal">"internal-padding"</code> style property</h3>
 670 <pre class="programlisting">  "internal-padding"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 671 <p>Amount of border space between the toolbar shadow and the buttons.</p>
 672 <p>Allowed values: &gt;= 0</p>
 673 <p>Default value: 0</p>
 674 </div>
 675 <hr>
 676 <div class="refsect2">
 677 <a name="GtkToolbar--s-max-child-expand"></a><h3>The <code class="literal">"max-child-expand"</code> style property</h3>
 678 <pre class="programlisting">  "max-child-expand"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 679 <p>Maximum amount of space an expandable item will be given.</p>
 680 <p>Allowed values: &gt;= 0</p>
 681 <p>Default value: 2147483647</p>
 682 </div>
 683 <hr>
 684 <div class="refsect2">
 685 <a name="GtkToolbar--s-shadow-type"></a><h3>The <code class="literal">"shadow-type"</code> style property</h3>
 686 <pre class="programlisting">  "shadow-type"              <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a>         : Read</pre>
 687 <p>Style of bevel around the toolbar.</p>
 688 <p>Default value: GTK_SHADOW_OUT</p>
 689 </div>
 690 <hr>
 691 <div class="refsect2">
 692 <a name="GtkToolbar--s-space-size"></a><h3>The <code class="literal">"space-size"</code> style property</h3>
 693 <pre class="programlisting">  "space-size"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 694 <p>Size of spacers.</p>
 695 <p>Allowed values: &gt;= 0</p>
 696 <p>Default value: 12</p>
 697 </div>
 698 <hr>
 699 <div class="refsect2">
 700 <a name="GtkToolbar--s-space-style"></a><h3>The <code class="literal">"space-style"</code> style property</h3>
 701 <pre class="programlisting">  "space-style"              <a class="link" href="GtkToolbar.html#GtkToolbarSpaceStyle" title="enum GtkToolbarSpaceStyle"><span class="type">GtkToolbarSpaceStyle</span></a>  : Read</pre>
 702 <p>Whether spacers are vertical lines or just blank.</p>
 703 <p>Default value: GTK_TOOLBAR_SPACE_LINE</p>
 704 </div>
 705 </div>
 706 <div class="refsect1">
 707 <a name="GtkToolbar.signal-details"></a><h2>Signal Details</h2>
 708 <div class="refsect2">
 709 <a name="GtkToolbar-focus-home-or-end"></a><h3>The <code class="literal">"focus-home-or-end"</code> signal</h3>
 710 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar,
 711                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>    focus_home,
 712                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)       : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
 713 <p>
 714 A keybinding signal used internally by GTK+. This signal can't
 715 be used in application code
 716 </p>
 717 <div class="variablelist"><table border="0">
 718 <col align="left" valign="top">
 719 <tbody>
 720 <tr>
 721 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 722 <td>the <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal</td>
 723 </tr>
 724 <tr>
 725 <td><p><span class="term"><em class="parameter"><code>focus_home</code></em> :</span></p></td>
 726 <td>
 727 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the first item should be focused</td>
 728 </tr>
 729 <tr>
 730 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 731 <td>user data set when the signal handler was connected.</td>
 732 </tr>
 733 <tr>
 734 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 735 <td>
 736 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the signal was handled, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</td>
 737 </tr>
 738 </tbody>
 739 </table></div>
 740 </div>
 741 <hr>
 742 <div class="refsect2">
 743 <a name="GtkToolbar-orientation-changed"></a><h3>The <code class="literal">"orientation-changed"</code> signal</h3>
 744 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>    *toolbar,
 745                                                         <a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation,
 746                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>       user_data)        : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 747 <p>
 748 Emitted when the orientation of the toolbar changes.
 749 </p>
 750 <div class="variablelist"><table border="0">
 751 <col align="left" valign="top">
 752 <tbody>
 753 <tr>
 754 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 755 <td>the object which emitted the signal</td>
 756 </tr>
 757 <tr>
 758 <td><p><span class="term"><em class="parameter"><code>orientation</code></em> :</span></p></td>
 759 <td>the new <a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> of the toolbar</td>
 760 </tr>
 761 <tr>
 762 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 763 <td>user data set when the signal handler was connected.</td>
 764 </tr>
 765 </tbody>
 766 </table></div>
 767 </div>
 768 <hr>
 769 <div class="refsect2">
 770 <a name="GtkToolbar-popup-context-menu"></a><h3>The <code class="literal">"popup-context-menu"</code> signal</h3>
 771 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> *toolbar,
 772                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>        x,
 773                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>        y,
 774                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>        button,
 775                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>    user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 776 <p>
 777 Emitted when the user right-clicks the toolbar or uses the
 778 keybinding to display a popup menu.
 779 </p>
 780 <p>
 781 Application developers should handle this signal if they want
 782 to display a context menu on the toolbar. The context-menu should
 783 appear at the coordinates given by <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>. The mouse button
 784 number is given by the <em class="parameter"><code>button</code></em> parameter. If the menu was popped
 785 up using the keybaord, <em class="parameter"><code>button</code></em> is -1.
 786 </p>
 787 <div class="variablelist"><table border="0">
 788 <col align="left" valign="top">
 789 <tbody>
 790 <tr>
 791 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 792 <td>the <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal</td>
 793 </tr>
 794 <tr>
 795 <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
 796 <td>the x coordinate of the point where the menu should appear</td>
 797 </tr>
 798 <tr>
 799 <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
 800 <td>the y coordinate of the point where the menu should appear</td>
 801 </tr>
 802 <tr>
 803 <td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
 804 <td>the mouse button the user pressed, or -1</td>
 805 </tr>
 806 <tr>
 807 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 808 <td>user data set when the signal handler was connected.</td>
 809 </tr>
 810 <tr>
 811 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 812 <td>return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the signal was handled, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if not</td>
 813 </tr>
 814 </tbody>
 815 </table></div>
 816 </div>
 817 <hr>
 818 <div class="refsect2">
 819 <a name="GtkToolbar-style-changed"></a><h3>The <code class="literal">"style-changed"</code> signal</h3>
 820 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>     *toolbar,
 821                                                         <a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> style,
 822                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
 823 <p>
 824 Emitted when the style of the toolbar changes.
 825 </p>
 826 <div class="variablelist"><table border="0">
 827 <col align="left" valign="top">
 828 <tbody>
 829 <tr>
 830 <td><p><span class="term"><em class="parameter"><code>toolbar</code></em> :</span></p></td>
 831 <td>The <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal</td>
 832 </tr>
 833 <tr>
 834 <td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
 835 <td>the new <a class="link" href="gtk3-Standard-Enumerations.html#GtkToolbarStyle" title="enum GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> of the toolbar</td>
 836 </tr>
 837 <tr>
 838 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 839 <td>user data set when the signal handler was connected.</td>
 840 </tr>
 841 </tbody>
 842 </table></div>
 843 </div>
 844 </div>
 845 <div class="refsect1">
 846 <a name="GtkToolbar.see-also"></a><h2>See Also</h2>
 847 <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
 848 </div>
 849 </div>
 850 <div class="footer">
 851 <hr>
 852           Generated by GTK-Doc V1.18</div>
 853 </body>
 854 </html>