<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkToolbar">
<refmeta>
<refentrytitle role="top_of_page" id="GtkToolbar.top_of_page">GtkToolbar</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkToolbar</refname>
<refpurpose>Create bars of buttons and other widgets</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkToolbar.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkToolbar-struct">GtkToolbar</link>;
enum                <link linkend="GtkToolbarChildType">GtkToolbarChildType</link>;
enum                <link linkend="GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</link>;
                    <link linkend="GtkToolbarChild">GtkToolbarChild</link>;
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-toolbar-new">gtk_toolbar_new</link>                     (void);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-insert">gtk_toolbar_insert</link>                  (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolItem">GtkToolItem</link> *item,
                                                         <link linkend="gint">gint</link> pos);
<link linkend="gint">gint</link>                <link linkend="gtk-toolbar-get-item-index">gtk_toolbar_get_item_index</link>          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolItem">GtkToolItem</link> *item);
<link linkend="gint">gint</link>                <link linkend="gtk-toolbar-get-n-items">gtk_toolbar_get_n_items</link>             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="GtkToolItem">GtkToolItem</link> *       <link linkend="gtk-toolbar-get-nth-item">gtk_toolbar_get_nth_item</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> n);
<link linkend="gint">gint</link>                <link linkend="gtk-toolbar-get-drop-index">gtk_toolbar_get_drop_index</link>          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-set-drop-highlight-item">gtk_toolbar_set_drop_highlight_item</link> (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolItem">GtkToolItem</link> *tool_item,
                                                         <link linkend="gint">gint</link> index_);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-set-show-arrow">gtk_toolbar_set_show_arrow</link>          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gboolean">gboolean</link> show_arrow);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-set-orientation">gtk_toolbar_set_orientation</link>         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkOrientation">GtkOrientation</link> orientation);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-set-tooltips">gtk_toolbar_set_tooltips</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gboolean">gboolean</link> enable);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-unset-icon-size">gtk_toolbar_unset_icon_size</link>         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-toolbar-get-show-arrow">gtk_toolbar_get_show_arrow</link>          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="GtkOrientation">GtkOrientation</link>      <link linkend="gtk-toolbar-get-orientation">gtk_toolbar_get_orientation</link>         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="GtkToolbarStyle">GtkToolbarStyle</link>     <link linkend="gtk-toolbar-get-style">gtk_toolbar_get_style</link>               (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="GtkIconSize">GtkIconSize</link>         <link linkend="gtk-toolbar-get-icon-size">gtk_toolbar_get_icon_size</link>           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-toolbar-get-tooltips">gtk_toolbar_get_tooltips</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="GtkReliefStyle">GtkReliefStyle</link>      <link linkend="gtk-toolbar-get-relief-style">gtk_toolbar_get_relief_style</link>        (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-toolbar-append-item">gtk_toolbar_append_item</link>             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-toolbar-prepend-item">gtk_toolbar_prepend_item</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-toolbar-insert-item">gtk_toolbar_insert_item</link>             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="gint">gint</link> position);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-append-space">gtk_toolbar_append_space</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-prepend-space">gtk_toolbar_prepend_space</link>           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-insert-space">gtk_toolbar_insert_space</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> position);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-toolbar-append-element">gtk_toolbar_append_element</link>          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarChildType">GtkToolbarChildType</link> type,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-toolbar-prepend-element">gtk_toolbar_prepend_element</link>         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarChildType">GtkToolbarChildType</link> type,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-toolbar-insert-element">gtk_toolbar_insert_element</link>          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarChildType">GtkToolbarChildType</link> type,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="gint">gint</link> position);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-append-widget">gtk_toolbar_append_widget</link>           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-prepend-widget">gtk_toolbar_prepend_widget</link>          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-insert-widget">gtk_toolbar_insert_widget</link>           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="gint">gint</link> position);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-set-style">gtk_toolbar_set_style</link>               (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarStyle">GtkToolbarStyle</link> style);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gtk-toolbar-insert-stock">gtk_toolbar_insert_stock</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="gchar">gchar</link> *stock_id,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="gint">gint</link> position);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-set-icon-size">gtk_toolbar_set_icon_size</link>           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkIconSize">GtkIconSize</link> icon_size);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-remove-space">gtk_toolbar_remove_space</link>            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> position);
<link linkend="void">void</link>                <link linkend="gtk-toolbar-unset-style">gtk_toolbar_unset_style</link>             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkToolbar.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----GtkToolbar
</synopsis>
</refsect1>



<refsect1 id="GtkToolbar.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkToolbar implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkOrientable">GtkOrientable</link> and  <link linkend="GtkToolShell">GtkToolShell</link>.</para>
</refsect1>


<refsect1 id="GtkToolbar.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkToolbar--icon-size">icon-size</link>&quot;                <link linkend="gint">gint</link>                  : Read / Write
  &quot;<link linkend="GtkToolbar--icon-size-set">icon-size-set</link>&quot;            <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkToolbar--show-arrow">show-arrow</link>&quot;               <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkToolbar--toolbar-style">toolbar-style</link>&quot;            <link linkend="GtkToolbarStyle">GtkToolbarStyle</link>       : Read / Write
  &quot;<link linkend="GtkToolbar--tooltips">tooltips</link>&quot;                 <link linkend="gboolean">gboolean</link>              : Read / Write
</synopsis>
</refsect1>
<refsect1 id="GtkToolbar.child-properties" role="child_properties">
<title role="child_properties.title">Child Properties</title>
<synopsis>
  &quot;<link linkend="GtkToolbar--c-expand">expand</link>&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkToolbar--c-homogeneous">homogeneous</link>&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write
</synopsis>
</refsect1>
<refsect1 id="GtkToolbar.style-properties" role="style_properties">
<title role="style_properties.title">Style Properties</title>
<synopsis>
  &quot;<link linkend="GtkToolbar--s-button-relief">button-relief</link>&quot;            <link linkend="GtkReliefStyle">GtkReliefStyle</link>        : Read
  &quot;<link linkend="GtkToolbar--s-internal-padding">internal-padding</link>&quot;         <link linkend="gint">gint</link>                  : Read
  &quot;<link linkend="GtkToolbar--s-max-child-expand">max-child-expand</link>&quot;         <link linkend="gint">gint</link>                  : Read
  &quot;<link linkend="GtkToolbar--s-shadow-type">shadow-type</link>&quot;              <link linkend="GtkShadowType">GtkShadowType</link>         : Read
  &quot;<link linkend="GtkToolbar--s-space-size">space-size</link>&quot;               <link linkend="gint">gint</link>                  : Read
  &quot;<link linkend="GtkToolbar--s-space-style">space-style</link>&quot;              <link linkend="GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</link>  : Read
</synopsis>
</refsect1>

<refsect1 id="GtkToolbar.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkToolbar-focus-home-or-end">focus-home-or-end</link>&quot;                              : Run Last / Action
  &quot;<link linkend="GtkToolbar-orientation-changed">orientation-changed</link>&quot;                            : Run First
  &quot;<link linkend="GtkToolbar-popup-context-menu">popup-context-menu</link>&quot;                             : Run Last
  &quot;<link linkend="GtkToolbar-style-changed">style-changed</link>&quot;                                  : Run First
</synopsis>
</refsect1>


<refsect1 id="GtkToolbar.description" role="desc">
<title role="desc.title">Description</title>
<para>
A toolbar is created with a call to <link linkend="gtk-toolbar-new"><function>gtk_toolbar_new()</function></link>.
</para>
<para>
A toolbar can contain instances of a subclass of <link linkend="GtkToolItem"><type>GtkToolItem</type></link>. To add
a <link linkend="GtkToolItem"><type>GtkToolItem</type></link> to the a toolbar, use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link>. To remove
an item from the toolbar use <link linkend="gtk-container-remove"><function>gtk_container_remove()</function></link>. To add a button
to the toolbar, add an instance of <link linkend="GtkToolButton"><type>GtkToolButton</type></link>.
</para>
<para>
Toolbar items can be visually grouped by adding instances of
<link linkend="GtkSeparatorToolItem"><type>GtkSeparatorToolItem</type></link> to the toolbar. If a <link linkend="GtkSeparatorToolItem"><type>GtkSeparatorToolItem</type></link> has
the "expand" property set to <link linkend="TRUE--CAPS"><type>TRUE</type></link> and the "draw" property set to
<link linkend="FALSE--CAPS"><type>FALSE</type></link> the effect is to force all following items to the end of the
toolbar.
</para>
<para>
Creating a context menu for the toolbar can be done by connecting to
the <link linkend="GtkToolbar-popup-context-menu"><type>"popup-context-menu"</type></link> signal.
</para>
</refsect1>

<refsect1 id="GtkToolbar.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkToolbar-struct" role="struct">
<title>GtkToolbar</title>
<indexterm zone="GtkToolbar-struct"><primary sortas="Toolbar">GtkToolbar</primary></indexterm><programlisting>typedef struct {
  gint             GSEAL (num_children);
  GList           *GSEAL (children);
  GtkOrientation   GSEAL (orientation);
  GtkToolbarStyle  GSEAL (style);
  GtkIconSize      GSEAL (icon_size);

#ifndef GTK_DISABLE_DEPRECATED
  GtkTooltips     *GSEAL (tooltips);
#else
  gpointer         GSEAL (_tooltips);
#endif
} GtkToolbar;
</programlisting>
<para>
The <link linkend="GtkToolbar"><type>GtkToolbar</type></link> struct only contains private data and should only be
accessed through the function described below.
</para></refsect2>
<refsect2 id="GtkToolbarChildType" role="enum" condition="deprecated:">
<title>enum GtkToolbarChildType</title>
<indexterm zone="GtkToolbarChildType" role="deprecated"><primary sortas="ToolbarChildType">GtkToolbarChildType</primary></indexterm><programlisting>typedef enum
{
  GTK_TOOLBAR_CHILD_SPACE,
  GTK_TOOLBAR_CHILD_BUTTON,
  GTK_TOOLBAR_CHILD_TOGGLEBUTTON,
  GTK_TOOLBAR_CHILD_RADIOBUTTON,
  GTK_TOOLBAR_CHILD_WIDGET
} GtkToolbarChildType;
</programlisting>
<warning><para><literal>GtkToolbarChildType</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
<link linkend="GtkToolbarChildType"><type>GtkToolbarChildType</type></link> is used to set the type of new elements that are added
to a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</para><variablelist role="enum">
<varlistentry id="GTK-TOOLBAR-CHILD-SPACE--CAPS" role="constant">
<term><literal>GTK_TOOLBAR_CHILD_SPACE</literal></term>
<listitem><simpara>a space in the style of the toolbar's <link linkend="GtkToolbarSpaceStyle"><type>GtkToolbarSpaceStyle</type></link>.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-TOOLBAR-CHILD-BUTTON--CAPS" role="constant">
<term><literal>GTK_TOOLBAR_CHILD_BUTTON</literal></term>
<listitem><simpara>a <link linkend="GtkButton"><type>GtkButton</type></link>.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-TOOLBAR-CHILD-TOGGLEBUTTON--CAPS" role="constant">
<term><literal>GTK_TOOLBAR_CHILD_TOGGLEBUTTON</literal></term>
<listitem><simpara>a <link linkend="GtkToggleButton"><type>GtkToggleButton</type></link>.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-TOOLBAR-CHILD-RADIOBUTTON--CAPS" role="constant">
<term><literal>GTK_TOOLBAR_CHILD_RADIOBUTTON</literal></term>
<listitem><simpara>a <link linkend="GtkRadioButton"><type>GtkRadioButton</type></link>.
</simpara></listitem>
</varlistentry>
<varlistentry id="GTK-TOOLBAR-CHILD-WIDGET--CAPS" role="constant">
<term><literal>GTK_TOOLBAR_CHILD_WIDGET</literal></term>
<listitem><simpara>a standard <link linkend="GtkWidget"><type>GtkWidget</type></link>.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GtkToolbarSpaceStyle" role="enum">
<title>enum GtkToolbarSpaceStyle</title>
<indexterm zone="GtkToolbarSpaceStyle"><primary sortas="ToolbarSpaceStyle">GtkToolbarSpaceStyle</primary></indexterm><programlisting>typedef enum
{
  GTK_TOOLBAR_SPACE_EMPTY,
  GTK_TOOLBAR_SPACE_LINE
} GtkToolbarSpaceStyle;
</programlisting>
<para>
</para></refsect2>
<refsect2 id="GtkToolbarChild" role="struct" condition="deprecated:">
<title>GtkToolbarChild</title>
<indexterm zone="GtkToolbarChild" role="deprecated"><primary sortas="ToolbarChild">GtkToolbarChild</primary></indexterm><programlisting>typedef struct {
  GtkToolbarChildType type;
  GtkWidget *widget;
  GtkWidget *icon;
  GtkWidget *label;
} GtkToolbarChild;
</programlisting>
<warning><para><literal>GtkToolbarChild</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para></refsect2>
<refsect2 id="gtk-toolbar-new" role="function">
<title>gtk_toolbar_new ()</title>
<indexterm zone="gtk-toolbar-new"><primary sortas="toolbar_new">gtk_toolbar_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_toolbar_new                     (void);</programlisting>
<para>
Creates a new toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the newly-created toolbar.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-insert" role="function" condition="since:2.4">
<title>gtk_toolbar_insert ()</title>
<indexterm zone="gtk-toolbar-insert" role="2.4"><primary sortas="toolbar_insert">gtk_toolbar_insert</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_insert                  (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolItem">GtkToolItem</link> *item,
                                                         <link linkend="gint">gint</link> pos);</programlisting>
<para>
Insert a <link linkend="GtkToolItem"><type>GtkToolItem</type></link> into the toolbar at position <parameter>pos</parameter>. If <parameter>pos</parameter> is
0 the item is prepended to the start of the toolbar. If <parameter>pos</parameter> is
negative, the item is appended to the end of the toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolItem"><type>GtkToolItem</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pos</parameter>&#160;:</term>
<listitem><simpara> the position of the new item
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-get-item-index" role="function" condition="since:2.4">
<title>gtk_toolbar_get_item_index ()</title>
<indexterm zone="gtk-toolbar-get-item-index" role="2.4"><primary sortas="toolbar_get_item_index">gtk_toolbar_get_item_index</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_toolbar_get_item_index          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolItem">GtkToolItem</link> *item);</programlisting>
<para>
Returns the position of <parameter>item</parameter> on the toolbar, starting from 0.
It is an error if <parameter>item</parameter> is not a child of the toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolItem"><type>GtkToolItem</type></link> that is a child of <parameter>toolbar</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the position of item on the toolbar.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-get-n-items" role="function" condition="since:2.4">
<title>gtk_toolbar_get_n_items ()</title>
<indexterm zone="gtk-toolbar-get-n-items" role="2.4"><primary sortas="toolbar_get_n_items">gtk_toolbar_get_n_items</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_toolbar_get_n_items             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<para>
Returns the number of items on the toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the number of items on the toolbar

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-get-nth-item" role="function" condition="since:2.4">
<title>gtk_toolbar_get_nth_item ()</title>
<indexterm zone="gtk-toolbar-get-nth-item" role="2.4"><primary sortas="toolbar_get_nth_item">gtk_toolbar_get_nth_item</primary></indexterm><programlisting><link linkend="GtkToolItem">GtkToolItem</link> *       gtk_toolbar_get_nth_item            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> n);</programlisting>
<para>
Returns the <parameter>n</parameter><!-- -->'th item on <parameter>toolbar</parameter>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if the
toolbar does not contain an <parameter>n</parameter><!-- -->'th item.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>n</parameter>&#160;:</term>
<listitem><simpara> A position on the toolbar
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The <parameter>n</parameter><!-- -->'th <link linkend="GtkToolItem"><type>GtkToolItem</type></link> on <parameter>toolbar</parameter>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if there
isn't an <parameter>n</parameter><!-- -->'th item.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-get-drop-index" role="function" condition="since:2.4">
<title>gtk_toolbar_get_drop_index ()</title>
<indexterm zone="gtk-toolbar-get-drop-index" role="2.4"><primary sortas="toolbar_get_drop_index">gtk_toolbar_get_drop_index</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_toolbar_get_drop_index          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> x,
                                                         <link linkend="gint">gint</link> y);</programlisting>
<para>
Returns the position corresponding to the indicated point on
<parameter>toolbar</parameter>. This is useful when dragging items to the toolbar:
this function returns the position a new item should be
inserted.
</para>
<para>
<parameter>x</parameter> and <parameter>y</parameter> are in <parameter>toolbar</parameter> coordinates.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>x</parameter>&#160;:</term>
<listitem><simpara> x coordinate of a point on the toolbar
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>y</parameter>&#160;:</term>
<listitem><simpara> y coordinate of a point on the toolbar
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The position corresponding to the point (<parameter>x</parameter>, <parameter>y</parameter>) on the toolbar.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-set-drop-highlight-item" role="function" condition="since:2.4">
<title>gtk_toolbar_set_drop_highlight_item ()</title>
<indexterm zone="gtk-toolbar-set-drop-highlight-item" role="2.4"><primary sortas="toolbar_set_drop_highlight_item">gtk_toolbar_set_drop_highlight_item</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_set_drop_highlight_item (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolItem">GtkToolItem</link> *tool_item,
                                                         <link linkend="gint">gint</link> index_);</programlisting>
<para>
Highlights <parameter>toolbar</parameter> to give an idea of what it would look like
if <parameter>item</parameter> was added to <parameter>toolbar</parameter> at the position indicated by <parameter>index_</parameter>. 
If <parameter>item</parameter> is <link linkend="NULL--CAPS"><literal>NULL</literal></link>, highlighting is turned off. In that case <parameter>index_</parameter> 
is ignored.
</para>
<para>
The <parameter>tool_item</parameter> passed to this function must not be part of any widget
hierarchy. When an item is set as drop highlight item it can not
added to any widget hierarchy or used as highlight item for another
toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tool_item</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolItem"><type>GtkToolItem</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> to turn of highlighting
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index_</parameter>&#160;:</term>
<listitem><simpara> a position on <parameter>toolbar</parameter>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-set-show-arrow" role="function" condition="since:2.4">
<title>gtk_toolbar_set_show_arrow ()</title>
<indexterm zone="gtk-toolbar-set-show-arrow" role="2.4"><primary sortas="toolbar_set_show_arrow">gtk_toolbar_set_show_arrow</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_set_show_arrow          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gboolean">gboolean</link> show_arrow);</programlisting>
<para>
Sets whether to show an overflow menu when
<parameter>toolbar</parameter> doesn't have room for all items on it. If <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>,
items that there are not room are available through an
overflow menu.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show_arrow</parameter>&#160;:</term>
<listitem><simpara> Whether to show an overflow menu
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-set-orientation" role="function" condition="deprecated:2.16: Use gtk_orientable_set_orientation() instead.">
<title>gtk_toolbar_set_orientation ()</title>
<indexterm zone="gtk-toolbar-set-orientation" role="deprecated"><primary sortas="toolbar_set_orientation">gtk_toolbar_set_orientation</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_set_orientation         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkOrientation">GtkOrientation</link> orientation);</programlisting>
<warning><para><literal>gtk_toolbar_set_orientation</literal> has been deprecated since version 2.16 and should not be used in newly-written code. Use <link linkend="gtk-orientable-set-orientation"><function>gtk_orientable_set_orientation()</function></link> instead.</para></warning>
<para>
Sets whether a toolbar should appear horizontally or vertically.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>orientation</parameter>&#160;:</term>
<listitem><simpara> a new <link linkend="GtkOrientation"><type>GtkOrientation</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-set-tooltips" role="function" condition="deprecated">
<title>gtk_toolbar_set_tooltips ()</title>
<indexterm zone="gtk-toolbar-set-tooltips" role="deprecated"><primary sortas="toolbar_set_tooltips">gtk_toolbar_set_tooltips</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_set_tooltips            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gboolean">gboolean</link> enable);</programlisting>
<warning><para><literal>gtk_toolbar_set_tooltips</literal> has been deprecated since version 2.14 and should not be used in newly-written code. The toolkit-wide <link linkend="GtkSettings--gtk-enable-tooltips"><type>"gtk-enable-tooltips"</type></link> property
is now used instead.</para></warning>
<para>
Sets if the tooltips of a toolbar should be active or not.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>enable</parameter>&#160;:</term>
<listitem><simpara> set to <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> to disable the tooltips, or <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> to enable them.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-unset-icon-size" role="function">
<title>gtk_toolbar_unset_icon_size ()</title>
<indexterm zone="gtk-toolbar-unset-icon-size"><primary sortas="toolbar_unset_icon_size">gtk_toolbar_unset_icon_size</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_unset_icon_size         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<para>
Unsets toolbar icon size set with <link linkend="gtk-toolbar-set-icon-size"><function>gtk_toolbar_set_icon_size()</function></link>, so that
user preferences will be used to determine the icon size.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-get-show-arrow" role="function" condition="since:2.4">
<title>gtk_toolbar_get_show_arrow ()</title>
<indexterm zone="gtk-toolbar-get-show-arrow" role="2.4"><primary sortas="toolbar_get_show_arrow">gtk_toolbar_get_show_arrow</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_toolbar_get_show_arrow          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<para>
Returns whether the toolbar has an overflow menu.
See <link linkend="gtk-toolbar-set-show-arrow"><function>gtk_toolbar_set_show_arrow()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the toolbar has an overflow menu.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-get-orientation" role="function" condition="deprecated:2.16: Use gtk_orientable_get_orientation() instead.">
<title>gtk_toolbar_get_orientation ()</title>
<indexterm zone="gtk-toolbar-get-orientation" role="deprecated"><primary sortas="toolbar_get_orientation">gtk_toolbar_get_orientation</primary></indexterm><programlisting><link linkend="GtkOrientation">GtkOrientation</link>      gtk_toolbar_get_orientation         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<warning><para><literal>gtk_toolbar_get_orientation</literal> has been deprecated since version 2.16 and should not be used in newly-written code. Use <link linkend="gtk-orientable-get-orientation"><function>gtk_orientable_get_orientation()</function></link> instead.</para></warning>
<para>
Retrieves the current orientation of the toolbar. See
<link linkend="gtk-toolbar-set-orientation"><function>gtk_toolbar_set_orientation()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the orientation

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-get-style" role="function">
<title>gtk_toolbar_get_style ()</title>
<indexterm zone="gtk-toolbar-get-style"><primary sortas="toolbar_get_style">gtk_toolbar_get_style</primary></indexterm><programlisting><link linkend="GtkToolbarStyle">GtkToolbarStyle</link>     gtk_toolbar_get_style               (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<para>
Retrieves whether the toolbar has text, icons, or both . See
<link linkend="gtk-toolbar-set-style"><function>gtk_toolbar_set_style()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the current style of <parameter>toolbar</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-get-icon-size" role="function">
<title>gtk_toolbar_get_icon_size ()</title>
<indexterm zone="gtk-toolbar-get-icon-size"><primary sortas="toolbar_get_icon_size">gtk_toolbar_get_icon_size</primary></indexterm><programlisting><link linkend="GtkIconSize">GtkIconSize</link>         gtk_toolbar_get_icon_size           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<para>
Retrieves the icon size for the toolbar. See <link linkend="gtk-toolbar-set-icon-size"><function>gtk_toolbar_set_icon_size()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the current icon size for the icons on the toolbar.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-get-tooltips" role="function" condition="deprecated">
<title>gtk_toolbar_get_tooltips ()</title>
<indexterm zone="gtk-toolbar-get-tooltips" role="deprecated"><primary sortas="toolbar_get_tooltips">gtk_toolbar_get_tooltips</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_toolbar_get_tooltips            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<warning><para><literal>gtk_toolbar_get_tooltips</literal> has been deprecated since version 2.14 and should not be used in newly-written code. The toolkit-wide <link linkend="GtkSettings--gtk-enable-tooltips"><type>"gtk-enable-tooltips"</type></link> property
is now used instead.</para></warning>
<para>
Retrieves whether tooltips are enabled. See
<link linkend="gtk-toolbar-set-tooltips"><function>gtk_toolbar_set_tooltips()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if tooltips are enabled

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-get-relief-style" role="function" condition="since:2.4">
<title>gtk_toolbar_get_relief_style ()</title>
<indexterm zone="gtk-toolbar-get-relief-style" role="2.4"><primary sortas="toolbar_get_relief_style">gtk_toolbar_get_relief_style</primary></indexterm><programlisting><link linkend="GtkReliefStyle">GtkReliefStyle</link>      gtk_toolbar_get_relief_style        (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<para>
Returns the relief style of buttons on <parameter>toolbar</parameter>. See
<link linkend="gtk-button-set-relief"><function>gtk_button_set_relief()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The relief style of buttons on <parameter>toolbar</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-toolbar-append-item" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_append_item ()</title>
<indexterm zone="gtk-toolbar-append-item" role="deprecated"><primary sortas="toolbar_append_item">gtk_toolbar_append_item</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_toolbar_append_item             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<warning><para><literal>gtk_toolbar_append_item</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Inserts a new item into the toolbar. You must specify the position
in the toolbar where it will be inserted.
</para>
<para>
<parameter>callback</parameter> must be a pointer to a function taking a <link linkend="GtkWidget"><type>GtkWidget</type></link> and a gpointer as
arguments. Use <link linkend="G-CALLBACK--CAPS"><function>G_CALLBACK()</function></link> to cast the function to <link linkend="GCallback"><type>GCallback</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara> give your toolbar button a label.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> a string that appears when the user holds the mouse over this item.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> use with <link linkend="GtkTipsQuery"><type>GtkTipsQuery</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> that should be used as the button's icon.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to be executed when the button is pressed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> a pointer to any data you wish to be passed to the callback.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the new toolbar item as a <link linkend="GtkWidget"><type>GtkWidget</type></link>.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-prepend-item" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_prepend_item ()</title>
<indexterm zone="gtk-toolbar-prepend-item" role="deprecated"><primary sortas="toolbar_prepend_item">gtk_toolbar_prepend_item</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_toolbar_prepend_item            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<warning><para><literal>gtk_toolbar_prepend_item</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Adds a new button to the beginning (top or left edges) of the given toolbar.
</para>
<para>
<parameter>callback</parameter> must be a pointer to a function taking a <link linkend="GtkWidget"><type>GtkWidget</type></link> and a gpointer as
arguments. Use <link linkend="G-CALLBACK--CAPS"><function>G_CALLBACK()</function></link> to cast the function to <link linkend="GCallback"><type>GCallback</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara> give your toolbar button a label.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> a string that appears when the user holds the mouse over this item.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> use with <link linkend="GtkTipsQuery"><type>GtkTipsQuery</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> that should be used as the button's icon.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to be executed when the button is pressed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> a pointer to any data you wish to be passed to the callback.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the new toolbar item as a <link linkend="GtkWidget"><type>GtkWidget</type></link>.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-insert-item" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_insert_item ()</title>
<indexterm zone="gtk-toolbar-insert-item" role="deprecated"><primary sortas="toolbar_insert_item">gtk_toolbar_insert_item</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_toolbar_insert_item             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<warning><para><literal>gtk_toolbar_insert_item</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Inserts a new item into the toolbar. You must specify the position in the
toolbar where it will be inserted.
</para>
<para>
<parameter>callback</parameter> must be a pointer to a function taking a <link linkend="GtkWidget"><type>GtkWidget</type></link> and a gpointer as
arguments. Use <link linkend="G-CALLBACK--CAPS"><function>G_CALLBACK()</function></link> to cast the function to <link linkend="GCallback"><type>GCallback</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara> give your toolbar button a label.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> a string that appears when the user holds the mouse over this item.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> use with <link linkend="GtkTipsQuery"><type>GtkTipsQuery</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> that should be used as the button's icon.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to be executed when the button is pressed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> a pointer to any data you wish to be passed to the callback.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the number of widgets to insert this item after.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the new toolbar item as a <link linkend="GtkWidget"><type>GtkWidget</type></link>.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-append-space" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_append_space ()</title>
<indexterm zone="gtk-toolbar-append-space" role="deprecated"><primary sortas="toolbar_append_space">gtk_toolbar_append_space</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_append_space            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<warning><para><literal>gtk_toolbar_append_space</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Adds a new space to the end of the toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-prepend-space" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_prepend_space ()</title>
<indexterm zone="gtk-toolbar-prepend-space" role="deprecated"><primary sortas="toolbar_prepend_space">gtk_toolbar_prepend_space</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_prepend_space           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<warning><para><literal>gtk_toolbar_prepend_space</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Adds a new space to the beginning of the toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-insert-space" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_insert_space ()</title>
<indexterm zone="gtk-toolbar-insert-space" role="deprecated"><primary sortas="toolbar_insert_space">gtk_toolbar_insert_space</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_insert_space            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<warning><para><literal>gtk_toolbar_insert_space</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Inserts a new space in the toolbar at the specified position.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the number of widgets after which a space should be inserted.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-append-element" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_append_element ()</title>
<indexterm zone="gtk-toolbar-append-element" role="deprecated"><primary sortas="toolbar_append_element">gtk_toolbar_append_element</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_toolbar_append_element          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarChildType">GtkToolbarChildType</link> type,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<warning><para><literal>gtk_toolbar_append_element</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Adds a new element to the end of a toolbar.
</para>
<para>
If <parameter>type</parameter> == <link linkend="GTK-TOOLBAR-CHILD-WIDGET--CAPS"><literal>GTK_TOOLBAR_CHILD_WIDGET</literal></link>, <parameter>widget</parameter> is used as the new element.
If <parameter>type</parameter> == <link linkend="GTK-TOOLBAR-CHILD-RADIOBUTTON--CAPS"><literal>GTK_TOOLBAR_CHILD_RADIOBUTTON</literal></link>, <parameter>widget</parameter> is used to determine
the radio group for the new element. In all other cases, <parameter>widget</parameter> must
be <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</para>
<para>
<parameter>callback</parameter> must be a pointer to a function taking a <link linkend="GtkWidget"><type>GtkWidget</type></link> and a gpointer as
arguments. Use <link linkend="G-CALLBACK--CAPS"><function>G_CALLBACK()</function></link> to cast the function to <link linkend="GCallback"><type>GCallback</type></link>.</para>
<para>
</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara> a value of type <link linkend="GtkToolbarChildType"><type>GtkToolbarChildType</type></link> that determines what <parameter>widget</parameter> will be.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara> the element's label.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> the element's tooltip.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> used for context-sensitive help about this toolbar element.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> that provides pictorial representation of the element's function.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to be executed when the button is pressed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> any data you wish to pass to the callback.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the new toolbar element as a <link linkend="GtkWidget"><type>GtkWidget</type></link>.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-prepend-element" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_prepend_element ()</title>
<indexterm zone="gtk-toolbar-prepend-element" role="deprecated"><primary sortas="toolbar_prepend_element">gtk_toolbar_prepend_element</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_toolbar_prepend_element         (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarChildType">GtkToolbarChildType</link> type,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<warning><para><literal>gtk_toolbar_prepend_element</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Adds a new element to the beginning of a toolbar.
</para>
<para>
If <parameter>type</parameter> == <link linkend="GTK-TOOLBAR-CHILD-WIDGET--CAPS"><literal>GTK_TOOLBAR_CHILD_WIDGET</literal></link>, <parameter>widget</parameter> is used as the new element.
If <parameter>type</parameter> == <link linkend="GTK-TOOLBAR-CHILD-RADIOBUTTON--CAPS"><literal>GTK_TOOLBAR_CHILD_RADIOBUTTON</literal></link>, <parameter>widget</parameter> is used to determine
the radio group for the new element. In all other cases, <parameter>widget</parameter> must
be <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</para>
<para>
<parameter>callback</parameter> must be a pointer to a function taking a <link linkend="GtkWidget"><type>GtkWidget</type></link> and a gpointer as
arguments. Use <link linkend="G-CALLBACK--CAPS"><function>G_CALLBACK()</function></link> to cast the function to <link linkend="GCallback"><type>GCallback</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara> a value of type <link linkend="GtkToolbarChildType"><type>GtkToolbarChildType</type></link> that determines what <parameter>widget</parameter> will be.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara> the element's label.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> the element's tooltip.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> used for context-sensitive help about this toolbar element.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> that provides pictorial representation of the element's function.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to be executed when the button is pressed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> any data you wish to pass to the callback.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the new toolbar element as a <link linkend="GtkWidget"><type>GtkWidget</type></link>.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-insert-element" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_insert_element ()</title>
<indexterm zone="gtk-toolbar-insert-element" role="deprecated"><primary sortas="toolbar_insert_element">gtk_toolbar_insert_element</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_toolbar_insert_element          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarChildType">GtkToolbarChildType</link> type,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *text,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GtkWidget">GtkWidget</link> *icon,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<warning><para><literal>gtk_toolbar_insert_element</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Inserts a new element in the toolbar at the given position. 
</para>
<para>
If <parameter>type</parameter> == <link linkend="GTK-TOOLBAR-CHILD-WIDGET--CAPS"><literal>GTK_TOOLBAR_CHILD_WIDGET</literal></link>, <parameter>widget</parameter> is used as the new element.
If <parameter>type</parameter> == <link linkend="GTK-TOOLBAR-CHILD-RADIOBUTTON--CAPS"><literal>GTK_TOOLBAR_CHILD_RADIOBUTTON</literal></link>, <parameter>widget</parameter> is used to determine
the radio group for the new element. In all other cases, <parameter>widget</parameter> must
be <link linkend="NULL--CAPS"><literal>NULL</literal></link>.
</para>
<para>
<parameter>callback</parameter> must be a pointer to a function taking a <link linkend="GtkWidget"><type>GtkWidget</type></link> and a gpointer as
arguments. Use <link linkend="G-CALLBACK--CAPS"><function>G_CALLBACK()</function></link> to cast the function to <link linkend="GCallback"><type>GCallback</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara> a value of type <link linkend="GtkToolbarChildType"><type>GtkToolbarChildType</type></link> that determines what <parameter>widget</parameter>
  will be.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>. 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara> the element's label.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> the element's tooltip.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> used for context-sensitive help about this toolbar element.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> that provides pictorial representation of the element's function.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to be executed when the button is pressed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> any data you wish to pass to the callback.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the number of widgets to insert this element after.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the new toolbar element as a <link linkend="GtkWidget"><type>GtkWidget</type></link>.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-append-widget" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_append_widget ()</title>
<indexterm zone="gtk-toolbar-append-widget" role="deprecated"><primary sortas="toolbar_append_widget">gtk_toolbar_append_widget</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_append_widget           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text);</programlisting>
<warning><para><literal>gtk_toolbar_append_widget</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Adds a widget to the end of the given toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> to add to the toolbar. 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> the element's tooltip.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> used for context-sensitive help about this toolbar element.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-prepend-widget" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_prepend_widget ()</title>
<indexterm zone="gtk-toolbar-prepend-widget" role="deprecated"><primary sortas="toolbar_prepend_widget">gtk_toolbar_prepend_widget</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_prepend_widget          (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text);</programlisting>
<warning><para><literal>gtk_toolbar_prepend_widget</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Adds a widget to the beginning of the given toolbar.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> to add to the toolbar. 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> the element's tooltip.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> used for context-sensitive help about this toolbar element.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-insert-widget" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_insert_widget ()</title>
<indexterm zone="gtk-toolbar-insert-widget" role="deprecated"><primary sortas="toolbar_insert_widget">gtk_toolbar_insert_widget</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_insert_widget           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *widget,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<warning><para><literal>gtk_toolbar_insert_widget</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Inserts a widget in the toolbar at the given position.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link> to add to the toolbar. 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> the element's tooltip.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> used for context-sensitive help about this toolbar element.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the number of widgets to insert this widget after.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-set-style" role="function">
<title>gtk_toolbar_set_style ()</title>
<indexterm zone="gtk-toolbar-set-style"><primary sortas="toolbar_set_style">gtk_toolbar_set_style</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_set_style               (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkToolbarStyle">GtkToolbarStyle</link> style);</programlisting>
<para>
Alters the view of <parameter>toolbar</parameter> to display either icons only, text only, or both.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>style</parameter>&#160;:</term>
<listitem><simpara> the new style for <parameter>toolbar</parameter>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-insert-stock" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_insert_stock ()</title>
<indexterm zone="gtk-toolbar-insert-stock" role="deprecated"><primary sortas="toolbar_insert_stock">gtk_toolbar_insert_stock</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gtk_toolbar_insert_stock            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         const <link linkend="gchar">gchar</link> *stock_id,
                                                         const <link linkend="char">char</link> *tooltip_text,
                                                         const <link linkend="char">char</link> *tooltip_private_text,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<warning><para><literal>gtk_toolbar_insert_stock</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Inserts a stock item at the specified position of the toolbar.  If
<parameter>stock_id</parameter> is not a known stock item ID, it's inserted verbatim,
except that underscores used to mark mnemonics are removed.
</para>
<para>
<parameter>callback</parameter> must be a pointer to a function taking a <link linkend="GtkWidget"><type>GtkWidget</type></link> and a gpointer as
arguments. Use <link linkend="G-CALLBACK--CAPS"><function>G_CALLBACK()</function></link> to cast the function to <link linkend="GCallback"><type>GCallback</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>stock_id</parameter>&#160;:</term>
<listitem><simpara> The id of the stock item you want to insert
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_text</parameter>&#160;:</term>
<listitem><simpara> The text in the tooltip of the toolbar button
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>tooltip_private_text</parameter>&#160;:</term>
<listitem><simpara> The private text of the tooltip
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> The callback called when the toolbar button is clicked.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> user data passed to callback
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> The position the button shall be inserted at.
           -1 means at the end.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the inserted widget

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-set-icon-size" role="function">
<title>gtk_toolbar_set_icon_size ()</title>
<indexterm zone="gtk-toolbar-set-icon-size"><primary sortas="toolbar_set_icon_size">gtk_toolbar_set_icon_size</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_set_icon_size           (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="GtkIconSize">GtkIconSize</link> icon_size);</programlisting>
<para>
This function sets the size of stock icons in the toolbar. You
can call it both before you add the icons and after they've been
added. The size you set will override user preferences for the default
icon size.
</para>
<para>
This should only be used for special-purpose toolbars, normal
application toolbars should respect the user preferences for the
size of icons.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>icon_size</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkIconSize"><type>GtkIconSize</type></link> that stock icons in the toolbar shall have.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-remove-space" role="function" condition="deprecated:2.4: Use gtk_toolbar_insert() instead.">
<title>gtk_toolbar_remove_space ()</title>
<indexterm zone="gtk-toolbar-remove-space" role="deprecated"><primary sortas="toolbar_remove_space">gtk_toolbar_remove_space</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_remove_space            (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                         <link linkend="gint">gint</link> position);</programlisting>
<warning><para><literal>gtk_toolbar_remove_space</literal> has been deprecated since version 2.4 and should not be used in newly-written code. Use <link linkend="gtk-toolbar-insert"><function>gtk_toolbar_insert()</function></link> instead.</para></warning>
<para>
Removes a space from the specified position.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>position</parameter>&#160;:</term>
<listitem><simpara> the index of the space to remove.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-toolbar-unset-style" role="function">
<title>gtk_toolbar_unset_style ()</title>
<indexterm zone="gtk-toolbar-unset-style"><primary sortas="toolbar_unset_style">gtk_toolbar_unset_style</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_toolbar_unset_style             (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar);</programlisting>
<para>
Unsets a toolbar style set with <link linkend="gtk-toolbar-set-style"><function>gtk_toolbar_set_style()</function></link>, so that
user preferences will be used to determine the toolbar style.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkToolbar"><type>GtkToolbar</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="GtkToolbar.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkToolbar--icon-size" role="property"><title>The <literal>&quot;icon-size&quot;</literal> property</title>
<indexterm zone="GtkToolbar--icon-size" role="2.10"><primary sortas="Toolbar:icon-size">GtkToolbar:icon-size</primary></indexterm><programlisting>  &quot;icon-size&quot;                <link linkend="gint">gint</link>                  : Read / Write</programlisting>
<para>
The size of the icons in a toolbar is normally determined by
the toolbar-icon-size setting. When this property is set, it
overrides the setting. 
</para>
<para>
This should only be used for special-purpose toolbars, normal
application toolbars should respect the user preferences for the
size of icons.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 3</para>
<para>Since 2.10</para>
</refsect2>
<refsect2 id="GtkToolbar--icon-size-set" role="property"><title>The <literal>&quot;icon-size-set&quot;</literal> property</title>
<indexterm zone="GtkToolbar--icon-size-set" role="2.10"><primary sortas="Toolbar:icon-size-set">GtkToolbar:icon-size-set</primary></indexterm><programlisting>  &quot;icon-size-set&quot;            <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
Is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the icon-size property has been set.</para>
<para>
</para><para>Default value: FALSE</para>
<para>Since 2.10</para>
</refsect2>
<refsect2 id="GtkToolbar--show-arrow" role="property"><title>The <literal>&quot;show-arrow&quot;</literal> property</title>
<indexterm zone="GtkToolbar--show-arrow"><primary sortas="Toolbar:show-arrow">GtkToolbar:show-arrow</primary></indexterm><programlisting>  &quot;show-arrow&quot;               <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>If an arrow should be shown if the toolbar doesn't fit.</para><para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkToolbar--toolbar-style" role="property"><title>The <literal>&quot;toolbar-style&quot;</literal> property</title>
<indexterm zone="GtkToolbar--toolbar-style"><primary sortas="Toolbar:toolbar-style">GtkToolbar:toolbar-style</primary></indexterm><programlisting>  &quot;toolbar-style&quot;            <link linkend="GtkToolbarStyle">GtkToolbarStyle</link>       : Read / Write</programlisting>
<para>How to draw the toolbar.</para><para>Default value: GTK_TOOLBAR_BOTH</para>
</refsect2>
<refsect2 id="GtkToolbar--tooltips" role="property"><title>The <literal>&quot;tooltips&quot;</literal> property</title>
<indexterm zone="GtkToolbar--tooltips" role="2.8"><primary sortas="Toolbar:tooltips">GtkToolbar:tooltips</primary></indexterm><programlisting>  &quot;tooltips&quot;                 <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
If the tooltips of the toolbar should be active or not.</para>
<para>
</para><para>Default value: TRUE</para>
<para>Since 2.8</para>
</refsect2>

</refsect1>
<refsect1 id="GtkToolbar.child-property-details" role="child_property_details">
<title role="child_property_details.title">Child Property Details</title>
<refsect2 id="GtkToolbar--c-expand" role="property"><title>The <literal>&quot;expand&quot;</literal> child property</title>
<indexterm zone="GtkToolbar--c-expand"><primary sortas="Toolbar:expand">GtkToolbar:expand</primary></indexterm><programlisting>  &quot;expand&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether the item should receive extra space when the toolbar grows.</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkToolbar--c-homogeneous" role="property"><title>The <literal>&quot;homogeneous&quot;</literal> child property</title>
<indexterm zone="GtkToolbar--c-homogeneous"><primary sortas="Toolbar:homogeneous">GtkToolbar:homogeneous</primary></indexterm><programlisting>  &quot;homogeneous&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>Whether the item should be the same size as other homogeneous items.</para><para>Default value: FALSE</para>
</refsect2>
</refsect1>
<refsect1 id="GtkToolbar.style-property-details" role="style_properties_details">
<title role="style_properties_details.title">Style Property Details</title>
<refsect2 id="GtkToolbar--s-button-relief" role="property"><title>The <literal>&quot;button-relief&quot;</literal> style property</title>
<indexterm zone="GtkToolbar--s-button-relief"><primary sortas="Toolbar:button-relief">GtkToolbar:button-relief</primary></indexterm><programlisting>  &quot;button-relief&quot;            <link linkend="GtkReliefStyle">GtkReliefStyle</link>        : Read</programlisting>
<para>Type of bevel around toolbar buttons.</para><para>Default value: GTK_RELIEF_NONE</para>
</refsect2>
<refsect2 id="GtkToolbar--s-internal-padding" role="property"><title>The <literal>&quot;internal-padding&quot;</literal> style property</title>
<indexterm zone="GtkToolbar--s-internal-padding"><primary sortas="Toolbar:internal-padding">GtkToolbar:internal-padding</primary></indexterm><programlisting>  &quot;internal-padding&quot;         <link linkend="gint">gint</link>                  : Read</programlisting>
<para>Amount of border space between the toolbar shadow and the buttons.</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 0</para>
</refsect2>
<refsect2 id="GtkToolbar--s-max-child-expand" role="property"><title>The <literal>&quot;max-child-expand&quot;</literal> style property</title>
<indexterm zone="GtkToolbar--s-max-child-expand"><primary sortas="Toolbar:max-child-expand">GtkToolbar:max-child-expand</primary></indexterm><programlisting>  &quot;max-child-expand&quot;         <link linkend="gint">gint</link>                  : Read</programlisting>
<para>Maximum amount of space an expandable item will be given.</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 2147483647</para>
</refsect2>
<refsect2 id="GtkToolbar--s-shadow-type" role="property"><title>The <literal>&quot;shadow-type&quot;</literal> style property</title>
<indexterm zone="GtkToolbar--s-shadow-type"><primary sortas="Toolbar:shadow-type">GtkToolbar:shadow-type</primary></indexterm><programlisting>  &quot;shadow-type&quot;              <link linkend="GtkShadowType">GtkShadowType</link>         : Read</programlisting>
<para>Style of bevel around the toolbar.</para><para>Default value: GTK_SHADOW_OUT</para>
</refsect2>
<refsect2 id="GtkToolbar--s-space-size" role="property"><title>The <literal>&quot;space-size&quot;</literal> style property</title>
<indexterm zone="GtkToolbar--s-space-size"><primary sortas="Toolbar:space-size">GtkToolbar:space-size</primary></indexterm><programlisting>  &quot;space-size&quot;               <link linkend="gint">gint</link>                  : Read</programlisting>
<para>Size of spacers.</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 12</para>
</refsect2>
<refsect2 id="GtkToolbar--s-space-style" role="property"><title>The <literal>&quot;space-style&quot;</literal> style property</title>
<indexterm zone="GtkToolbar--s-space-style"><primary sortas="Toolbar:space-style">GtkToolbar:space-style</primary></indexterm><programlisting>  &quot;space-style&quot;              <link linkend="GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</link>  : Read</programlisting>
<para>Whether spacers are vertical lines or just blank.</para><para>Default value: GTK_TOOLBAR_SPACE_LINE</para>
</refsect2>
</refsect1>

<refsect1 id="GtkToolbar.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkToolbar-focus-home-or-end" role="signal"><title>The <literal>&quot;focus-home-or-end&quot;</literal> signal</title>
<indexterm zone="GtkToolbar-focus-home-or-end"><primary sortas="Toolbar::focus-home-or-end">GtkToolbar::focus-home-or-end</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            user_function                      (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                        <link linkend="gboolean">gboolean</link>    focus_home,
                                                        <link linkend="gpointer">gpointer</link>    user_data)       : Run Last / Action</programlisting>
<para>
A keybinding signal used internally by GTK+. This signal can't
be used in application code</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkToolbar"><type>GtkToolbar</type></link> which emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>focus_home</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the first item should be focused
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the signal was handled, <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if not
</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkToolbar-orientation-changed" role="signal"><title>The <literal>&quot;orientation-changed&quot;</literal> signal</title>
<indexterm zone="GtkToolbar-orientation-changed"><primary sortas="Toolbar::orientation-changed">GtkToolbar::orientation-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkToolbar">GtkToolbar</link>    *toolbar,
                                                        <link linkend="GtkOrientation">GtkOrientation</link> orientation,
                                                        <link linkend="gpointer">gpointer</link>       user_data)        : Run First</programlisting>
<para>
Emitted when the orientation of the toolbar changes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> the object which emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>orientation</parameter>&#160;:</term>
<listitem><simpara> the new <link linkend="GtkOrientation"><type>GtkOrientation</type></link> of the toolbar
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkToolbar-popup-context-menu" role="signal"><title>The <literal>&quot;popup-context-menu&quot;</literal> signal</title>
<indexterm zone="GtkToolbar-popup-context-menu"><primary sortas="Toolbar::popup-context-menu">GtkToolbar::popup-context-menu</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            user_function                      (<link linkend="GtkToolbar">GtkToolbar</link> *toolbar,
                                                        <link linkend="gint">gint</link>        x,
                                                        <link linkend="gint">gint</link>        y,
                                                        <link linkend="gint">gint</link>        button,
                                                        <link linkend="gpointer">gpointer</link>    user_data)      : Run Last</programlisting>
<para>
Emitted when the user right-clicks the toolbar or uses the
keybinding to display a popup menu.
</para>
<para>
Application developers should handle this signal if they want
to display a context menu on the toolbar. The context-menu should
appear at the coordinates given by <parameter>x</parameter> and <parameter>y</parameter>. The mouse button
number is given by the <parameter>button</parameter> parameter. If the menu was popped
up using the keybaord, <parameter>button</parameter> is -1.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GtkToolbar"><type>GtkToolbar</type></link> which emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>x</parameter>&#160;:</term>
<listitem><simpara> the x coordinate of the point where the menu should appear
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>y</parameter>&#160;:</term>
<listitem><simpara> the y coordinate of the point where the menu should appear
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara> the mouse button the user pressed, or -1
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> return <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the signal was handled, <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if not
</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GtkToolbar-style-changed" role="signal"><title>The <literal>&quot;style-changed&quot;</literal> signal</title>
<indexterm zone="GtkToolbar-style-changed"><primary sortas="Toolbar::style-changed">GtkToolbar::style-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkToolbar">GtkToolbar</link>     *toolbar,
                                                        <link linkend="GtkToolbarStyle">GtkToolbarStyle</link> style,
                                                        <link linkend="gpointer">gpointer</link>        user_data)      : Run First</programlisting>
<para>
Emitted when the style of the toolbar changes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>toolbar</parameter>&#160;:</term>
<listitem><simpara> The <link linkend="GtkToolbar"><type>GtkToolbar</type></link> which emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>style</parameter>&#160;:</term>
<listitem><simpara> the new <link linkend="GtkToolbarStyle"><type>GtkToolbarStyle</type></link> of the toolbar
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>


<refsect1 id="GtkToolbar.see-also">
<title>See Also</title>
<para>
<variablelist>
<varlistentry>
<term><link linkend="GtkToolItem"><type>GtkToolItem</type></link></term>
<listitem><para>Base class of widgets that can be added to a toolbar.</para></listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

</refentry>
