<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtktoolbar">
  <refnamediv>
    <refname>gtk.Toolbar</refname>
    <refpurpose>a bar holding buttons and other widgets.</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <classsynopsis language="python">
      <ooclass><classname>gtk.Toolbar</classname></ooclass>
      <ooclass><classname><link
linkend="class-gtkcontainer">gtk.Container</link></classname></ooclass>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gtktoolbar">gtk.Toolbar</link></methodname>
	<methodparam></methodparam>
      </constructorsynopsis>

      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--insert">insert</link></methodname>
	<methodparam><parameter role="keyword">item</parameter></methodparam>
	<methodparam><parameter role="keyword">pos</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--get-item-index">get_item_index</link></methodname>
	<methodparam><parameter role="keyword">item</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--get-n-items">get_n_items</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--get-nth-item">get_nth_item</link></methodname>
	<methodparam><parameter role="keyword">n</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--get-drop-index">get_drop_index</link></methodname>
	<methodparam><parameter role="keyword">x</parameter></methodparam>
	<methodparam><parameter role="keyword">y</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--set-drop-highlight-item">set_drop_highlight_item</link></methodname>
	<methodparam><parameter role="keyword">tool_item</parameter></methodparam>
	<methodparam><parameter role="keyword">index</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--set-show-arrow">set_show_arrow</link></methodname>
	<methodparam><parameter role="keyword">show_arrow</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--get-show-arrow">get_show_arrow</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gtktoolbar--get-relief-style">get_relief_style</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>

      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--append-item">append_item</link></methodname>
	<methodparam><parameter
		       role="keyword">text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">icon</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">callback</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">user_data</parameter><initializer>None</initializer></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--prepend-item">prepend_item</link></methodname>
	<methodparam><parameter
		       role="keyword">text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">icon</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">callback</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">user_data</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--insert-item">insert_item</link></methodname>
	<methodparam><parameter
		       role="keyword">text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">icon</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">callback</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">user_data</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--insert-stock">insert_stock</link></methodname>
	<methodparam><parameter
		       role="keyword">stock_id</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">callback</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">user_data</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--append-space">append_space</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--prepend-space">prepend_space</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--insert-space">insert_space</link></methodname>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--remove-space">remove_space</link></methodname>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--append-element">append_element</link></methodname>
	<methodparam><parameter
		       role="keyword">type</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">widget</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">icon</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">callback</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">user_data</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--prepend-element">prepend_element</link></methodname>
	<methodparam><parameter
		       role="keyword">type</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">widget</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">icon</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">callback</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">user_data</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--insert-element">insert_element</link></methodname>
	<methodparam><parameter
		       role="keyword">type</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">widget</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">icon</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">callback</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">user_data</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--append-widget">append_widget</link></methodname>
	<methodparam><parameter
		       role="keyword">widget</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--prepend-widget">prepend_widget</link></methodname>
	<methodparam><parameter
		       role="keyword">widget</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--insert-widget">insert_widget</link></methodname>
	<methodparam><parameter
		       role="keyword">widget</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">tooltip_private_text</parameter></methodparam>
	<methodparam><parameter
		       role="keyword">position</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--set-orientation">set_orientation</link></methodname>
	<methodparam><parameter
		       role="keyword">orientation</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--set-style">set_style</link></methodname>
	<methodparam><parameter
		       role="keyword">style</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--set-icon-size">set_icon_size</link></methodname>
	<methodparam><parameter
		       role="keyword">icon_size</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--set-tooltips">set_tooltips</link></methodname>
	<methodparam><parameter
		       role="keyword">enable</parameter></methodparam>
      </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--unset-style">unset_style</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--unset-icon-size">unset_icon_size</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--get-orientation">get_orientation</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--get-style">get_style</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--get-icon-size">get_icon_size</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
      <methodsynopsis language="python">
	<methodname><link
linkend="method-gtktoolbar--get-tooltips">get_tooltips</link></methodname>
	<methodparam></methodparam>  </methodsynopsis>
    </classsynopsis>

  </refsect1>

  <refsect1>
    <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkobject">gtk.Object</link>
    +-- <link linkend="class-gtkwidget">gtk.Widget</link>
      +-- <link linkend="class-gtkcontainer">gtk.Container</link>
        +-- <link linkend="class-gtktoolbar">gtk.Toolbar</link>
</synopsis>

  </refsect1>
  
  <refsect1>
		<title>Implemented Interfaces</title>
		<para>
			<link linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link>
			implements 
			<link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
		</para>
	</refsect1>


  <refsect1 id="properties-gtktoolbar">
    <title>gtk.Toolbar Properties</title>

    <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para>
    <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para>
    <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

            <row valign="top">
              <entry>"icon-size"</entry>
              <entry>Read-Write</entry>
              <entry>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.  This should only be used for
              special-purpose toolbars, normal application toolbars should
              respect the user preferences for the size of icons.  This property
              is available in GTK+ 2.10 and above.</entry>
            </row>

            <row valign="top">
              <entry>"icon-size-set"</entry>
              <entry>Read-Write</entry>
              <entry>if <literal>True</literal> the icon-size property has
              been set.  This property is available in GTK+ 2.10 and
              above.</entry>
            </row>

            <row valign="top">
	      <entry>"orientation"</entry>
	      <entry>Read-Write</entry>
	      <entry>The orientation of the toolbar:
<literal>gtk.ORIENTATION_HORIZONTAL</literal> or
<literal>gtk.ORIENTATION_VERTICAL</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"show-arrow"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal> an arrow should be shown
if the toolbar doesn't fit. Available in GTK+ 2.4 and above.</entry>
	    </row>

	    <row valign="top">
	      <entry>"toolbar-style"</entry>
	      <entry>Read-Write</entry>
	      <entry>The toolbar style:
<literal>gtk.TOOLBAR_ICONS</literal>, <literal>gtk.TOOLBAR_TEXT</literal>,
<literal>gtk.TOOLBAR_BOTH</literal> or
<literal>gtk.TOOLBAR_BOTH_HORIZ</literal></entry>
	    </row>

            <row valign="top">
              <entry>"tooltips"</entry>
              <entry>Read-Write</entry>
              <entry>If the tooltips of the toolbar should be active or not.
              This property is available in GTK+ 2.8 and above.</entry>
            </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

   <refsect1 id="style-properties-gtktoolbar">
    <title>gtk.Toolbar Style Properties</title>

    <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"button-relief"</entry>
	      <entry>Read</entry>
	      <entry>The type of bevel around toolbar buttons:
<literal>gtk.RELIEF_NORMAL</literal>, <literal>gtk.RELIEF_HALF</literal> or
<literal>gtk.RELIEF_NONE</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"internal-padding"</entry>
	      <entry>Read</entry>
	      <entry>The amount of border space between the toolbar shadow
and the buttons</entry>
	    </row>

            <row valign="top">
              <entry>"max-child-expand"</entry>
              <entry>Read</entry>
              <entry>Maximum amount of space an expandable item will be given</entry>
            </row>

	    <row valign="top">
	      <entry>"shadow-type"</entry>
	      <entry>Read</entry>
	      <entry>The style of bevel around the toolbar:
<literal>gtk.SHADOW_NONE</literal>, <literal>gtk.SHADOW_IN</literal>,
<literal>gtk.SHADOW_OUT</literal>, <literal>gtk.SHADOW_ETCHED_IN</literal>
or <literal>gtk.SHADOW_ETCHED_OUT</literal></entry>
	    </row>

	    <row valign="top">
	      <entry>"space-size"</entry>
	      <entry>Read</entry>
	      <entry>The size of spacers</entry>
	    </row>

	    <row valign="top">
	      <entry>"space-style"</entry>
	      <entry>Read</entry>
	      <entry>The spacer style:
<literal>gtk.TOOLBAR_SPACE_EMPTY</literal> or
<literal>gtk.TOOLBAR_SPACE_LINE</literal></entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="child-properties-gtktoolbar">
    <title>gtk.Toolbar Child Properties</title>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"expand"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, the item should receive
extra space when the toolbar grows. Available in GTK+ 2.4 and above.</entry>
	    </row>

	  </tbody>
	    <row valign="top">
	      <entry>"homogeneous"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal>, the item should be the
same size as other homogeneous items. Available in GTK+ 2.4 and above.</entry>
	    </row>

	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="signal-prototypes-gtktoolbar">
    <title>gtk.Toolbar Signal Prototypes</title>

    <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>

    <variablelist>
      <varlistentry>
        <term>"<link linkend="signal-gtktoolbar--focus-home-or-end">focus-home-or-end</link></term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>toolbar</parameter></methodparam>
            <methodparam><parameter>focus_home</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
     <varlistentry>
        <term>"<link linkend="signal-gtktoolbar--move-focus">move-focus</link></term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>toolbar</parameter></methodparam>
            <methodparam><parameter>dir</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
       <varlistentry>
        <term>"<link
linkend="signal-gtktoolbar--orientation-changed">orientation-changed</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>toolbar</parameter></methodparam>
            <methodparam><parameter>orientation</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link
linkend="signal-gtktoolbar--popup-context-menu">popup-context-menu</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>toolbar</parameter></methodparam>
            <methodparam><parameter>x</parameter></methodparam>
            <methodparam><parameter>y</parameter></methodparam>
            <methodparam><parameter>button</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>"<link
linkend="signal-gtktoolbar--style-changed">style-changed</link>"</term>
        <listitem>
          <methodsynopsis
	    language="python"><methodname>callback</methodname>
            <methodparam><parameter>toolbar</parameter></methodparam>
            <methodparam><parameter>style</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>A <link
linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link> is a
subclass of <link
linkend="class-gtkcontainer"><classname>gtk.Container</classname></link>
that holds and manages a set of buttons and widgets in a horizontal or
vertical bar. A <link
linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link> is
usually used in an application as an alternative to a menu to provide a more
direct means to activate dialogs or set options. Items in the toolbar can be
visibly grouped by adding space between the elements. The toolbar style can
be set to display only icons, only text or both icons and text. Each toolbar
item has an associated <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> to
provide a brief description of the items purpose.</para>

    <para>In <literal>PyGTK</literal> 2.4 the interface of the <link
linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link> has
changed to take advantage of the new <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
widgets.  The following describes the new features.</para>

    <para>A toolbar can contain instances of a subclass of <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
(<link
linkend="class-gtktoolbutton"><classname>gtk.ToolButton</classname></link>,
<link
linkend="class-gtkradiotoolbutton"><classname>gtk.RadioToolButton</classname></link>,
<link
linkend="class-gtktoggletoolbutton"><classname>gtk.ToggleToolButton</classname></link>
and <link
linkend="class-gtkseparatortoolitem"><classname>gtk.SeparatorToolItem</classname></link>). To
add a <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link> to
the a toolbar, use the <link
linkend="method-gtktoolbar--insert"><methodname>insert</methodname>()</link>
method. To remove an item from the toolbar use the <link
linkend="method-gtkcontainer--remove"><methodname>gtk.Container.remove</methodname>()</link>
method. To add a button to the toolbar, add an instance of <link
linkend="class-gtktoolbutton"><classname>gtk.ToolButton</classname></link>. Toolbar
items can be visually grouped by adding instances of <link
linkend="class-gtkseparatortoolitem"><classname>gtk.SeparatorToolItem</classname></link>
to the toolbar. If a <link
linkend="class-gtkseparatortoolitem"><classname>gtk.SeparatorToolItem</classname></link>
has the "expand" property set to <literal>True</literal> and the "draw"
property set to <literal>False</literal> the effect is to force all
following items to the end of the toolbar. Creating a context menu for the
toolbar can be done by connecting to the "popup-context-menu" signal.</para>

  </refsect1>

  <refsect1 id="constructor-gtktoolbar">
    <title>Constructor</title>

    <programlisting><constructorsynopsis language="python">
	<methodname>gtk.Toolbar</methodname>
	<methodparam></methodparam>  </constructorsynopsis></programlisting>
    <variablelist>
      <varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	<listitem><simpara>a new <link
linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link>
widget</simpara></listitem>
      </varlistentry>
    </variablelist>

    <para>Creates a new <link
linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link>
widget.</para>

  </refsect1>

  <refsect1>
    <title>Methods</title>

    <refsect2 id="method-gtktoolbar--insert">
      <title>gtk.Toolbar.insert</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert</methodname>
	  <methodparam><parameter role="keyword">item</parameter></methodparam>
	  <methodparam><parameter role="keyword">pos</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">item</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">pos</parameter>&nbsp;:</term>
	  <listitem><simpara>the position of the new item</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>insert</methodname>() method inserts the <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
specified by <parameter>item</parameter> into the toolbar at the position
specified by <parameter>pos</parameter>. If <parameter>pos</parameter> is 0
<parameter>item</parameter> is prepended to the start of the toolbar. If
<parameter>pos</parameter> is negative, <parameter>item</parameter> is
appended to the end of the toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-item-index">
      <title>gtk.Toolbar.get_item_index</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_item_index</methodname>
	  <methodparam><parameter role="keyword">item</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">item</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
	  linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
	  that is a child of the toolbar</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the position of item on the
	  toolbar.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>get_item_index</methodname>() method returns the
position (starting from 0) on the toolbar of the <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
specified by <parameter>item</parameter>.  It is an error
if <parameter>item</parameter> is not a child of the toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-n-items">
      <title>gtk.Toolbar.get_n_items</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_n_items</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the number of items on the
	  toolbar</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>get_n_items</methodname>() method returns the
number of items on the toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-nth-item">
      <title>gtk.Toolbar.get_nth_item</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_nth_item</methodname>
	  <methodparam><parameter role="keyword">n</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">n</parameter>&nbsp;:</term>
	  <listitem><simpara>a position on the toolbar</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>The <link
	  linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
	  on the toolbar at position <parameter>n</parameter>, or
	  <literal>None</literal> if there isn't an item at position
	  <parameter>n</parameter></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>get_nth_item</methodname>() method returns the
toolbar <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link> at
the position specified by <parameter>n</parameter>, or
<literal>None</literal> if the toolbar does not contain an item at position
<parameter>n</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-drop-index">
      <title>gtk.Toolbar.get_drop_index</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_drop_index</methodname>
	  <methodparam><parameter role="keyword">x</parameter></methodparam>
	  <methodparam><parameter role="keyword">y</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">x</parameter>&nbsp;:</term>
	  <listitem><simpara>the x coordinate of a point on the
	  toolbar</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">y</parameter>&nbsp;:</term>
	  <listitem><simpara>the y coordinate of a point on the
	  toolbar</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>The toolbar position corresponding to the point
	  (<parameter>x</parameter>,
	  <parameter>y</parameter>).</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>get_drop_index</methodname>() method returns the
position on the toolbar corresponding to the point specified by
<parameter>x</parameter> and <parameter>y</parameter>. This is useful when
dragging items to the toolbar. This method returns the position index where
a new item should be inserted.</para>

      <para>The <parameter>x</parameter> and <parameter>y</parameter>
coordinates are relative to the toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--set-drop-highlight-item">
      <title>gtk.Toolbar.set_drop_highlight_item</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_drop_highlight_item</methodname>
	  <methodparam><parameter role="keyword">tool_item</parameter></methodparam>
	  <methodparam><parameter role="keyword">index</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
	  role="keyword">tool_item</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
	  linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>,
	  or <literal>None</literal> to turn off
	  highlighting</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">index</parameter>&nbsp;:</term>
	  <listitem><simpara>a position index on the toolbar</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>set_drop_highlight_item</methodname>() method
highlights the toolbar to give an idea of what it would look like if the
<link linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
specified by <parameter>tool_item</parameter> was added at the position
specified by <parameter>index</parameter>. If
<parameter>tool_item</parameter> is <literal>None</literal>, highlighting is
turned off and <parameter>index</parameter> is ignored.</para>

      <para>The <parameter>tool_item</parameter> passed to this method 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>

    </refsect2>

    <refsect2 id="method-gtktoolbar--set-show-arrow">
      <title>gtk.Toolbar.set_show_arrow</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_show_arrow</methodname>
	  <methodparam><parameter role="keyword">show_arrow</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
	  role="keyword">show_arrow</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal>, show an arrow to
	  indicate menu overflow</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>set_show_arrow</methodname>() method sets the
"show-arrow" property to the value of <parameter>show_arrow</parameter>. If
<parameter>show_arrow</parameter> is <literal>True</literal> an arrow is
displayed (for an overflow menu) when the toolbar doesn't have room for all
items on it. Items that are not displayed due to a lack of room are
available through the overflow menu.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-show-arrow">
      <title>gtk.Toolbar.get_show_arrow</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_show_arrow</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if an overflow menu can
	  be used</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>get_show_arrow</methodname>() method returns the
value of the "show-arrow" property. If "show-arrow" is
<literal>True</literal> the toolbar has an overflow menu.  See the <link
linkend="method-gtktoolbar--set-show-arrow"><methodname>set_show_arrow()</methodname></link>
method for more information.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-relief-style">
      <title>gtk.Toolbar.get_relief_style</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_relief_style</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the relief style of buttons on the
	  toolbar</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.4 and above</para>
      </note>

      <para>The <methodname>get_relief_style</methodname>() method returns
the relief style of buttons on the toolbar. See the <link
linkend="method-gtkbutton--set-relief"><methodname>gtk.Button.set_relief()</methodname></link>
method for more information. The return value will be one of:</para>

    <itemizedlist>
      <listitem>
	  <simpara><literal>gtk.RELIEF_NORMAL</literal></simpara>
      </listitem>
      <listitem>
	<simpara><literal>gtk.RELIEF_HALF</literal></simpara>
      </listitem>
      <listitem>
	<simpara><literal>gtk.RELIEF_NONE</literal></simpara>
      </listitem>
   </itemizedlist>

    </refsect2>

    <refsect2 id="method-gtktoolbar--append-item">
      <title>gtk.Toolbar.append_item</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>append_item</methodname>
	  <methodparam><parameter
			 role="keyword">text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">icon</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">callback</parameter></methodparam>
	  <methodparam><parameter role="keyword">user_data</parameter>
	    <initializer>None</initializer></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">text</parameter>&nbsp;:</term>
	  <listitem><simpara>the text label or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">icon</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">callback</parameter>&nbsp;:</term>
	  <listitem><simpara>a callback function or method or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">user_data</parameter>&nbsp;:</term>
	  <listitem><simpara>a user data object or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkbutton"><classname>gtk.Button</classname></link>
widget</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>append_item</methodname>() method adds a new
<link linkend="class-gtkbutton"><classname>gtk.Button</classname></link> to
the end (right or bottom) of the toolbar with:</para>

      <itemizedlist>
	<listitem>
	  <simpara>the label specified by
<parameter>text</parameter>,</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> text
and private text specified by <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> respectively and</simpara>
	</listitem>
	<listitem>
	  <simpara>an icon (or any <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>)
specified by <parameter>icon</parameter>.</simpara>
	</listitem>
      </itemizedlist>

      <para>A reference to the new button is returned. When the button is
clicked the function or method specified by <parameter>callback</parameter>
will be called with the user data specified by
<parameter>user_data</parameter>. All or any of the arguments can have the
value <parameter>None</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--prepend-item">
      <title>gtk.Toolbar.prepend_item</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>prepend_item</methodname>
	  <methodparam><parameter
			 role="keyword">text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">icon</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">callback</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">user_data</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">text</parameter>&nbsp;:</term>
	  <listitem><simpara>the text label or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">icon</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">callback</parameter>&nbsp;:</term>
	  <listitem><simpara>a callback function or method or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">user_data</parameter>&nbsp;:</term>
	  <listitem><simpara>a user data object or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkbutton"><classname>gtk.Button</classname></link>
widget</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>prepend_item</methodname>() method adds a new
<link linkend="class-gtkbutton"><classname>gtk.Button</classname></link> to
the beginning (left or top) of the toolbar with:</para>

      <itemizedlist>
	<listitem>
	  <simpara>the label specified by
<parameter>text</parameter>,</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> text
and private text specified by <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> respectively and</simpara>
	</listitem>
	<listitem>
	  <simpara>an icon (or any <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>)
specified by <parameter>icon</parameter>.</simpara>
	</listitem>
      </itemizedlist>

      <para>A reference to the new button is returned. When the button is
clicked the function or method specified by <parameter>callback</parameter>
will be called with the user data specified by
<parameter>user_data</parameter>. All or any of the arguments can have the
value <parameter>None</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--insert-item">
      <title>gtk.Toolbar.insert_item</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_item</methodname>
	  <methodparam><parameter
			 role="keyword">text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">icon</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">callback</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">user_data</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">text</parameter>&nbsp;:</term>
	  <listitem><simpara>the text label or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">icon</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">callback</parameter>&nbsp;:</term>
	  <listitem><simpara>a callback function or method or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">user_data</parameter>&nbsp;:</term>
	  <listitem><simpara>a user data object or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>The position to insert the button or -1 to
append</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkbutton"><classname>gtk.Button</classname></link>
widget</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>insert_item</methodname>() method inserts a new
<link linkend="class-gtkbutton"><classname>gtk.Button</classname></link> the
toolbar at the position specified by <parameter>position</parameter>
with:</para>

      <itemizedlist>
	<listitem>
	  <simpara>the label specified by
<parameter>text</parameter>,</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> text
and private text specified by <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> respectively and</simpara>
	</listitem>
	<listitem>
	  <simpara>an icon (or any <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>)
specified by <parameter>icon</parameter>.</simpara>
	</listitem>
      </itemizedlist>

      <para>A reference to the new button is returned. When the button is
clicked the function or method specified by <parameter>callback</parameter>
will be called with the user data specified by
<parameter>user_data</parameter>. All or any of the arguments (except
<parameter>position</parameter>) can have the value
<parameter>None</parameter>. If <parameter>position</parameter> is negative
the button will be appended to the toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--insert-stock">
      <title>gtk.Toolbar.insert_stock</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_stock</methodname>
	  <methodparam><parameter
			 role="keyword">stock_id</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">callback</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">user_data</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">stock_id</parameter>&nbsp;:</term>
	  <listitem><simpara>the ID of the stock item to use as the button
label and icon</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">callback</parameter>&nbsp;:</term>
	  <listitem><simpara>a callback function or method or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">user_data</parameter>&nbsp;:</term>
	  <listitem><simpara>a user data object or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>The position to insert the button or -1 to
append</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkbutton"><classname>gtk.Button</classname></link>
widget</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>insert_stock</methodname>() method inserts a new
<link linkend="class-gtkbutton"><classname>gtk.Button</classname></link> the
toolbar at the position specified by <parameter>position</parameter>
with:</para>

      <itemizedlist>
	<listitem>
	  <simpara>the stock item specified by
<parameter>stock_id</parameter> used for the label text and icon,</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> text
and private text specified by <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> respectively.</simpara>
	</listitem>
      </itemizedlist>

      <para>A reference to the new button is returned. When the button is
clicked the function or method specified by <parameter>callback</parameter>
will be called with the user data specified by
<parameter>user_data</parameter>. All or any of the arguments (except
<parameter>position</parameter>) can have the value
<parameter>None</parameter>. If <parameter>position</parameter> is negative
the button will be appended to the toolbar. If
<parameter>stock_id</parameter> is not a known stock item ID, it's inserted
verbatim, except that underscores are used to mark mnemonic
accelerators.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--append-space">
      <title>gtk.Toolbar.append_space</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>append_space</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>append_space</methodname>() method appends a
space to the end of the toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--prepend-space">
      <title>gtk.Toolbar.prepend_space</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>prepend_space</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>prepend_space</methodname>() method prepends a
space to the beginning of the toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--insert-space">
      <title>gtk.Toolbar.insert_space</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_space</methodname>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>The position to insert the space or -1 to
append</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>insert_space</methodname>() method inserts a
space at the specified <parameter>position</parameter> in the
toolbar.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--remove-space">
      <title>gtk.Toolbar.remove_space</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>remove_space</methodname>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>the index of the space to
remove.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>remove_space</methodname>() method removes a
space from the specified <parameter>position</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--append-element">
      <title>gtk.Toolbar.append_element</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>append_element</methodname>
	  <methodparam><parameter
			 role="keyword">type</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">icon</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">callback</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">user_data</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">type</parameter>&nbsp;:</term>
	  <listitem><simpara>the type of <parameter>widget</parameter> - one
of: <literal>gtk.TOOLBAR_CHILD_SPACE</literal>,
<literal>gtk.TOOLBAR_CHILD_BUTTON</literal>,
<literal>gtk.TOOLBAR_CHILD_TOGGLEBUTTON</literal>,
<literal>gtk.TOOLBAR_CHILD_RADIOBUTTON</literal> or
<literal>gtk.TOOLBAR_CHILD_WIDGET</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">text</parameter>&nbsp;:</term>
	  <listitem><simpara>the text label or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">icon</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">callback</parameter>&nbsp;:</term>
	  <listitem><simpara>a callback function or method or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">user_data</parameter>&nbsp;:</term>
	  <listitem><simpara>a user data object or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the new toolbar element as a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>append_element</methodname>() method adds a new
element of the specified <parameter>type</parameter> to the end (right or
bottom) of the toolbar with the <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> text
and private text specified by <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> respectively. The behavior of
the method depends on the type of element being added:</para>

      <variablelist>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_WIDGET</literal></term>
	  <listitem>
	    <simpara>The specified <parameter>widget</parameter> is the
element added to the toolbar. The <parameter>text</parameter>,
<parameter>icon</parameter>, <parameter>callback</parameter> and
<parameter>user_data</parameter> arguments are ignored.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_BUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link linkend="class-gtkbutton"><classname>gtk.Button</classname></link> to
add to the toolbar. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal. The <parameter>widget</parameter> argument must have the value
<literal>None</literal>.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_TOGGLEBUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link
linkend="class-gtktogglebutton"><classname>gtk.ToggleButton</classname></link> 
to add to the toolbar. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal. The <parameter>widget</parameter> argument must have the value
<literal>None</literal>.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_RADIOBUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link
linkend="class-gtkradiobutton"><classname>gtk.RadioButton</classname></link>
to add to the toolbar. The <link
linkend="class-gtkradiobutton"><classname>gtk.RadioButton</classname></link>
specified by <parameter>widget</parameter> is used to set the group for the
radiobutton. If <parameter>widget</parameter> is <literal>None</literal> a
new radiobutton group is created. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_SPACE</literal></term>
	  <listitem>
	    <simpara>A space element is added to the toolbar. The
<parameter>widget</parameter> argument must have the value
<literal>None</literal>. The <parameter>text</parameter>,
<parameter>icon</parameter>, <parameter>tooltip_text</parameter>,
<parameter>tooltip_private_text</parameter>, <parameter>callback</parameter>
and <parameter>user_data</parameter> arguments are ignored.</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

      <para>The <parameter>text</parameter>, <parameter>icon</parameter>,
<parameter>callback</parameter>, <parameter>user_data</parameter>,
<parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> arguments may have the value
<parameter>None</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--prepend-element">
      <title>gtk.Toolbar.prepend_element</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>prepend_element</methodname>
	  <methodparam><parameter
			 role="keyword">type</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">icon</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">callback</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">user_data</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">type</parameter>&nbsp;:</term>
	  <listitem><simpara>the type of <parameter>widget</parameter> - one
of: <literal>gtk.TOOLBAR_CHILD_SPACE</literal>,
<literal>gtk.TOOLBAR_CHILD_BUTTON</literal>,
<literal>gtk.TOOLBAR_CHILD_TOGGLEBUTTON</literal>,
<literal>gtk.TOOLBAR_CHILD_RADIOBUTTON</literal> or
<literal>gtk.TOOLBAR_CHILD_WIDGET</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">text</parameter>&nbsp;:</term>
	  <listitem><simpara>the text label or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">icon</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">callback</parameter>&nbsp;:</term>
	  <listitem><simpara>a callback function or method or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">user_data</parameter>&nbsp;:</term>
	  <listitem><simpara>a user data object or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the new toolbar element as a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>prepend_element</methodname>() method adds a new
element of the specified <parameter>type</parameter> to the beginning (left
or top) of the toolbar with the <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> text
and private text specified by <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> respectively. The behavior of
the method depends on the type of element being added:</para>

      <variablelist>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_WIDGET</literal></term>
	  <listitem>
	    <simpara>The widget specified by <parameter>widget</parameter>
is the element added to the toolbar, otherwise <parameter>widget</parameter>
should be <literal>None</literal>. The <parameter>text</parameter>,
<parameter>icon</parameter>, <parameter>callback</parameter> and
<parameter>user_data</parameter> arguments are ignored.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_BUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link linkend="class-gtkbutton"><classname>gtk.Button</classname></link> to
add to the toolbar. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal. The <parameter>widget</parameter> argument must have the value
<literal>None</literal>.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_TOGGLEBUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link
linkend="class-gtktogglebutton"><classname>gtk.ToggleButton</classname></link> 
to add to the toolbar. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal. The <parameter>widget</parameter> argument must have the value
<literal>None</literal>.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_RADIOBUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link
linkend="class-gtkradiobutton"><classname>gtk.RadioButton</classname></link>
to add to the toolbar. The <link
linkend="class-gtkradiobutton"><classname>gtk.RadioButton</classname></link>
specified by <parameter>widget</parameter> is used to set the group for the
radiobutton. If <parameter>widget</parameter> is <literal>None</literal> a
new radiobutton group is created. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_SPACE</literal></term>
	  <listitem>
	    <simpara>A space element is added to the toolbar. The
<parameter>widget</parameter> argument must have the value
<literal>None</literal>. The <parameter>text</parameter>,
<parameter>icon</parameter>, <parameter>tooltip_text</parameter>,
<parameter>tooltip_private_text</parameter>, <parameter>callback</parameter>
and <parameter>user_data</parameter> arguments are ignored.</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

      <para>The <parameter>text</parameter>, <parameter>icon</parameter>,
<parameter>callback</parameter>, <parameter>user_data</parameter>,
<parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> arguments may have the value
<parameter>None</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--insert-element">
      <title>gtk.Toolbar.insert_element</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_element</methodname>
	  <methodparam><parameter
			 role="keyword">type</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">icon</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">callback</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">user_data</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">type</parameter>&nbsp;:</term>
	  <listitem><simpara>the type of <parameter>widget</parameter> - one
of: <literal>gtk.TOOLBAR_CHILD_SPACE</literal>,
<literal>gtk.TOOLBAR_CHILD_BUTTON</literal>,
<literal>gtk.TOOLBAR_CHILD_TOGGLEBUTTON</literal>,
<literal>gtk.TOOLBAR_CHILD_RADIOBUTTON</literal> or
<literal>gtk.TOOLBAR_CHILD_WIDGET</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
	  <listitem><simpara>a widget or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">text</parameter>&nbsp;:</term>
	  <listitem><simpara>the text label or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">icon</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">callback</parameter>&nbsp;:</term>
	  <listitem><simpara>a callback function or method or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">user_data</parameter>&nbsp;:</term>
	  <listitem><simpara>a user data object or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>the position to insert the new element
at.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the new toolbar element as a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>insert_element</methodname>() method adds a new
element of the specified <parameter>type</parameter> at the specified
<parameter>position</parameter> in the toolbar with the <link
linkend="class-gtktooltips"><classname>gtk.Tooltips</classname></link> text
and private text specified by <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> respectively. The behavior of
the method depends on the type of element being added:</para>

      <variablelist>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_WIDGET</literal></term>
	  <listitem>
	    <simpara>The widget specified by <parameter>widget</parameter>
is the element added to the toolbar, otherwise <parameter>widget</parameter>
should be <literal>None</literal>. The <parameter>text</parameter>,
<parameter>icon</parameter>, <parameter>callback</parameter> and
<parameter>user_data</parameter> arguments are ignored.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_BUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link linkend="class-gtkbutton"><classname>gtk.Button</classname></link> to
add to the toolbar. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal. The <parameter>widget</parameter> argument must have the value
<literal>None</literal>.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_TOGGLEBUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link
linkend="class-gtktogglebutton"><classname>gtk.ToggleButton</classname></link> 
to add to the toolbar. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal. The <parameter>widget</parameter> argument must have the value
<literal>None</literal>.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_RADIOBUTTON</literal></term>
	  <listitem>
	    <simpara>The string specified by <parameter>text</parameter> and
the <link linkend="class-gtkwidget"><classname>gtk.Widget</classname></link>
specified by <parameter>icon</parameter> are used to create the label for a
<link
linkend="class-gtkradiobutton"><classname>gtk.RadioButton</classname></link>
to add to the toolbar. The <link
linkend="class-gtkradiobutton"><classname>gtk.RadioButton</classname></link>
specified by <parameter>widget</parameter> is used to set the group for the
radiobutton. If <parameter>widget</parameter> is <literal>None</literal> a
new radiobutton group is created. The function or method specified by
<parameter>callback</parameter> and the object specified by
<parameter>user_data</parameter> are connected to the button's "clicked"
signal.</simpara>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term><literal>gtk.TOOLBAR_CHILD_SPACE</literal></term>
	  <listitem>
	    <simpara>A space element is added to the toolbar. The
<parameter>widget</parameter> argument must have the value
<literal>None</literal>. The <parameter>text</parameter>,
<parameter>icon</parameter>, <parameter>tooltip_text</parameter>,
<parameter>tooltip_private_text</parameter>, <parameter>callback</parameter>
and <parameter>user_data</parameter> arguments are ignored.</simpara>
	  </listitem>
	</varlistentry>
      </variablelist>

      <para>The <parameter>text</parameter>, <parameter>icon</parameter>,
<parameter>callback</parameter>, <parameter>user_data</parameter>,
<parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> arguments may have the value
<parameter>None</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--append-widget">
      <title>gtk.Toolbar.append_widget</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>append_widget</methodname>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to add to
the toolbar.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>append_widget</methodname>() method adds the
specified <parameter>widget</parameter> to the end (right or bottom) of the
toolbar. <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> specify the tooltip text and
private text respectively.</para>

    </refsect2>

  <refsect2 id="method-gtktoolbar--prepend-widget">
      <title>gtk.Toolbar.prepend_widget</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>prepend_widget</methodname>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to add to
the toolbar.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>prepend_widget</methodname>() method adds the
specified <parameter>widget</parameter> to the start (left or top) of the
toolbar. <parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> specify the tooltip text and
private text respectively.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--insert-widget">
      <title>gtk.Toolbar.insert_widget</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>insert_widget</methodname>
	  <methodparam><parameter
			 role="keyword">widget</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">tooltip_private_text</parameter></methodparam>
	  <methodparam><parameter
			 role="keyword">position</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">widget</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gtkwidget"><classname>gtk.Widget</classname></link> to add to
the toolbar.</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter
role="keyword">tooltip_private_text</parameter>&nbsp;:</term>
	  <listitem><simpara>the private tooltip text or
<literal>None</literal></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">position</parameter>&nbsp;:</term>
	  <listitem><simpara>the position to insert this widget
at.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <warning>
	<para>This method is deprecated in PyGTK 2.4 and above</para>
      </warning>

      <para>The <methodname>insert_widget</methodname>() method adds the
specified <parameter>widget</parameter> at the specified
<parameter>position</parameter> in the toolbar.
<parameter>tooltip_text</parameter> and
<parameter>tooltip_private_text</parameter> specify the tooltip text and
private text respectively.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--set-orientation">
      <title>gtk.Toolbar.set_orientation</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_orientation</methodname>
	  <methodparam><parameter
			 role="keyword">orientation</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">orientation</parameter>&nbsp;:</term>
	  <listitem><simpara>the new orientation either
<literal>gtk.ORIENTATION_HORIZONTAL</literal> or
<literal>gtk.ORIENTATION_VERTICAL</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_orientation</methodname>() method sets the
"orientation" property to the value of <parameter>orientation</parameter>.
The value of orientation is either
<literal>gtk.ORIENTATION_HORIZONTAL</literal> or
<literal>gtk.ORIENTATION_VERTICAL</literal></para>

    </refsect2>

  <refsect2 id="method-gtktoolbar--set-style">
      <title>gtk.Toolbar.set_style</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_style</methodname>
	  <methodparam><parameter
			 role="keyword">style</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">style</parameter>&nbsp;:</term>
	  <listitem><simpara>the new style - one of:
<literal>gtk.TOOLBAR_ICONS</literal>, <literal>gtk.TOOLBAR_TEXT</literal>,
<literal>gtk.TOOLBAR_BOTH</literal> or
<literal>gtk.TOOLBAR_BOTH_HORIZ</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_style</methodname>() method sets the
"toolbar-style" property to the value of <parameter>style</parameter>. The
value of <parameter>style</parameter> must be one of the <xref
linkend="gtk-toolbar-style-constants"
endterm="gtk-toolbar-style-constants-title"></xref>. Setting the style
overrides the user preferences for the toolbar style.</para>

      <note>
        <para>A <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link> label
will not be displayed if the toolbar style is
<literal>gtk.TOOLBAR_BOTH_HORIZ</literal> and the <link
linkend="class-gtktoolitem"><classname>gtk.ToolItem</classname></link>
"is-important" property is <literal>False</literal> (the default). See the
<link
linkend="method-gtktoolitem--set-is-important"><methodname>gtk.ToolItem.set_is_important</methodname>()</link>
method for more information.</para>
      </note>

    </refsect2>

    <refsect2 id="method-gtktoolbar--set-icon-size">
      <title>gtk.Toolbar.set_icon_size</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_icon_size</methodname>
	  <methodparam><parameter
			 role="keyword">icon_size</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter
role="keyword">icon_size</parameter>&nbsp;:</term>
	  <listitem><simpara>The size of stock icons in the toolbar - one
of: <literal>gtk.ICON_SIZE_MENU</literal>,
<literal>gtk.ICON_SIZE_SMALL_TOOLBAR</literal>,
<literal>gtk.ICON_SIZE_LARGE_TOOLBAR</literal>,
<literal>gtk.ICON_SIZE_BUTTON</literal>,
<literal>gtk.ICON_SIZE_DND</literal> or
<literal>gtk.ICON_SIZE_DIALOG</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_icon_size</methodname>() method sets the
size of stock icons in the toolbar to the value specified by
<parameter>icon_size</parameter>. The value of
<parameter>icon_size</parameter> must be one of:</para>

      <itemizedlist>
	<listitem>
	  <simpara><literal>gtk.ICON_SIZE_MENU</literal></simpara>
	</listitem>
	<listitem>
	  <simpara><literal>gtk.ICON_SIZE_SMALL_TOOLBAR</literal></simpara>
	</listitem>
	<listitem>
	  <simpara><literal>gtk.ICON_SIZE_LARGE_TOOLBAR</literal></simpara>
	</listitem>
	<listitem>
	  <simpara><literal>gtk.ICON_SIZE_BUTTON</literal></simpara>
	</listitem>
	<listitem>
	  <simpara><literal>gtk.ICON_SIZE_DND</literal>, or</simpara>
	</listitem>
	<listitem>
	  <simpara><literal>gtk.ICON_SIZE_DIALOG</literal></simpara>
	</listitem>
      </itemizedlist>

      <para>This method can be called both before and after adding the
icons. Setting the icon size will override the user preferences for the
default icon size.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--set-tooltips">
      <title>gtk.Toolbar.set_tooltips</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_tooltips</methodname>
	  <methodparam><parameter
			 role="keyword">enable</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">enable</parameter>&nbsp;:</term>
	  <listitem><simpara>if <literal>True</literal> tooltips should be
used</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>set_tooltips</methodname>() method enables or
disables tooltips for the toolbar depending on the value of
<parameter>enable</parameter>. If <parameter>enable</parameter> is
<literal>True</literal>, tooltips will be used.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--unset-style">
      <title>gtk.Toolbar.unset_style</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>unset_style</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>unset_style</methodname>() method unsets a
toolbar style set with the <link
linkend="method-gtktoolbar--set-style"><methodname>set_style</methodname>()</link> 
method, allowing the user preferences to determine the toolbar style.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--unset-icon-size">
      <title>gtk.Toolbar.unset_icon_size</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>unset_icon_size</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>

      <para>The <methodname>unset_icon_size</methodname>() method unsets
toolbar icon size set with the <link
linkend="method-gtktoolbar--set-icon-size"><methodname>set_icon_size</methodname>()</link>, 
allowing the user preferences to determine the icon size.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-orientation">
      <title>gtk.Toolbar.get_orientation</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_orientation</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the orientation</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_orientation</methodname>() method returns
the value of the "orientation" property that determines the current
orientation of the toolbar. See the <link
linkend="method-gtktoolbar--set-orientation"><methodname>set_orientation</methodname>()</link> 
method for more details.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-style">
      <title>gtk.Toolbar.get_style</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_style</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the current toolbar style</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_style</methodname>() method returns the
value of the "toolbar-style" property. See the <link
linkend="method-gtktoolbar--set-style"><methodname>set_style</methodname>()</link> 
method for more details.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-icon-size">
      <title>gtk.Toolbar.get_icon_size</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_icon_size</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the current icon size for the icons on the
toolbar.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_icon_size</methodname>() method returns the
current icon size for the toolbar. See the <link
linkend="method-gtktoolbar--set-icon-size"><methodname>set_icon_size</methodname>()</link> 
method for more details.</para>

    </refsect2>

    <refsect2 id="method-gtktoolbar--get-tooltips">
      <title>gtk.Toolbar.get_tooltips</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_tooltips</methodname>
	  <methodparam></methodparam>  </methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if tooltips are
enabled</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The <methodname>get_tooltips</methodname>() method returns
<literal>True</literal> if tooltips are enabled. See the <link
linkend="method-gtktoolbar--set-tooltips"><methodname>set_tooltips</methodname>()</link> 
method for more details.</para>

    </refsect2>

  </refsect1>

  <refsect1>
    <title>Signals</title>

    <refsect2 id="signal-gtktoolbar--focus-home-or-end">
      <title>The "focus-home-or-end" gtk.Toolbar Signal</title>

      <programlisting><methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>toolbar</parameter></methodparam>
            <methodparam><parameter>focus_home</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter>toolbar</parameter>&nbsp;:</term>
          <listitem><simpara>the <link linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link> which emitted the signal
 the object which received the signal.</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>focus_home</parameter>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the first item
          should be focused</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
          with the <link
          linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
          method</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>...</parameter>&nbsp;:</term>
          <listitem><simpara>additional user parameters (if any)</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the signal was
          handled, <literal>False</literal> if not</simpara></listitem>
        </varlistentry>
      </variablelist>

      <para>A keybinding signal used internally by GTK+. This signal can't
      be used in application code</para>

    </refsect2>

    <refsect2 id="signal-gtktoolbar--move-focus">
      <title>The "move-focus" gtk.Toolbar Signal</title>

      <programlisting><methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>toolbar</parameter></methodparam>
            <methodparam><parameter>dir</parameter></methodparam>
            <methodparam><parameter>arg1</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter>toolbar</parameter>&nbsp;:</term>
          <listitem><simpara>the <link
          linkend="class-gtktoolbar"><classname>gtk.Toolbar</classname></link>
          which emitted the signal the object which received the
          signal.</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>dir</parameter>&nbsp;:</term>
          <listitem><simpara>one of the <xref
          linkend="gtk-direction-type-constants"
          endterm="gtk-direction-type-constants-title"></xref></simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
          with the <link
          linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
          method</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>...</parameter>&nbsp;:</term>
          <listitem><simpara>additional user parameters (if any)</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara><literal>True</literal> if the signal was
          handled, <literal>False</literal> if not</simpara></listitem>
        </varlistentry>
      </variablelist>

      <para>A keybinding signal used internally by GTK+. This signal can't
      be used in application code.</para>

    </refsect2>

    <refsect2 id="signal-gtktoolbar--orientation-changed">
      <title>The "orientation-changed" gtk.Toolbar Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>toolbar</parameter></methodparam>
	  <methodparam><parameter>orientation</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>toolbar</parameter>&nbsp;:</term>
	  <listitem><simpara>the toolbar that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>orientation</parameter>&nbsp;:</term>
	  <listitem><simpara>the new orientation</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "orientation-changed" signal is emitted when the
<parameter>orientation</parameter> of <parameter>toolbar</parameter> is
changed.</para>

    </refsect2>

    <refsect2 id="signal-gtktoolbar--popup-context-menu">
      <title>The "popup-context-menu" gtk.Toolbar Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>toolbar</parameter></methodparam>
	  <methodparam><parameter>x</parameter></methodparam>
	  <methodparam><parameter>y</parameter></methodparam>
	  <methodparam><parameter>button</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>toolbar</parameter>&nbsp;:</term>
	  <listitem><simpara>the toolbar that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>x</parameter>&nbsp;:</term>
	  <listitem><simpara>the x coordinate of the mouse
event</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>y</parameter>&nbsp;:</term>
	  <listitem><simpara>the u coordinate of the mouse
event</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>button</parameter>&nbsp;:</term>
	  <listitem><simpara>the number of the mouse button</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the signal was
	  handled</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This signal is available in GTK+ 2.4 and above.</para>
      </note>

      <para>The "popup-context-menu" signal is emitted when the user
right-clicks the toolbar or uses the keybinding to display a popup
menu. 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
keyboard, <parameter>button</parameter> is -1.</para>

    </refsect2>

    <refsect2 id="signal-gtktoolbar--style-changed">
      <title>The "style-changed" gtk.Toolbar Signal</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>callback</methodname>
	  <methodparam><parameter>toolbar</parameter></methodparam>
	  <methodparam><parameter>style</parameter></methodparam>
	  <methodparam><parameter>user_param1</parameter></methodparam>
	  <methodparam><parameter>...</parameter></methodparam>
	</methodsynopsis></programlisting>

      <variablelist>
	<varlistentry>
	  <term><parameter>toolbar</parameter>&nbsp;:</term>
	  <listitem><simpara>the toolbar that received the
signal</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>style</parameter>&nbsp;:</term>
	  <listitem><simpara>the new style</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified
with the <link
linkend="method-gobject--connect"><methodname>connect</methodname>()</link>
method</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter>...</parameter>&nbsp;:</term>
	  <listitem><simpara>additional user parameters (if
any)</simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>The "style-changed" signal is emitted when the
<parameter>style</parameter> of <parameter>toolbar</parameter> is
changed.</para>

    </refsect2>

  </refsect1>

</refentry>
