<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="toolbar.py" xml:lang="es">
  <info>
    <title type="text">Toolbar (Python)</title>
    <link type="guide" xref="beginner.py#menu-combo-toolbar"/>
    <link type="seealso" xref="grid.py"/>
    <revision version="0.1" date="2012-06-05" status="draft"/>

    <credit type="author copyright">
      <name>Marta Maria Casetti</name>
      <email>mmcasetti@gmail.com</email>
      <years>2012</years>
    </credit>

    <desc>Una barra de botones y otros widgets</desc>
  </info>

  <title>Barra de herramientas</title>

  <media type="image" mime="image/png" src="media/toolbar.png"/>
  <p>Un ejemplo de barra de herramientas con botones (con iconos del almacén).</p>

  <links type="section"/>

  <section id="code">
    <title>Código usado para generar este ejemplo</title>

    <code mime="text/x-python" style="numbered"><xi:include href="samples/toolbar.py" parse="text"><xi:fallback/></xi:include></code>
  </section>

  <section id="methods">
    <title>Métodos útiles para un widget de barra de herramientas</title>

    <list>
      <item><p>Use <code>insert(tool_item, position)</code> para insertar el <code>tool_item</code> en <code>position</code>. Si <code>position</code> es negativo, el elemento se añade al final de la barra de herramientas.</p></item>
      <item><p><code>get_item_index(tool_item)</code> obtiene la posición de <code>tool_item</code> en la barra de herramientas.</p></item>
      <item><p><code>get_n_items()</code> devuelve el número de elementos en la barra de herramientas; <code>get_nth_item(position)</code> devuelve el elemento en la posición <code>position</code>.</p></item>
      <item><p>Si la barra de herramientas no tiene espacio para todos los elementos del menú, y <code>set_show_arrow(True)</code>, los elementos que no entran se muestran a través de un menú flotante.</p></item>
      <item><p><code>set_icon_size(icon_size)</code> establece el tamaño de los iconos en la barra de herramientas; <code>icon_size</code> puede ser uno de <code>Gtk.IconSize.INVALID, Gtk.IconSize.MENU, Gtk.IconSize.SMALL_TOOLBAR, Gtk.IconSize.LARGE_TOOLBAR, Gtk.IconSize.BUTTON, Gtk.IconSize.DND, Gtk.IconSize.DIALOG</code>. Esto solo debe usarse para barras de herramientas con propósitos especiales, las barras de herramientas de aplicaciones normales deben respetar las preferencias del usuario para el tamaño de los iconos. <code>unset_icon_size()</code> restablece las preferencias establecidas con <code>set_icon_size(icon_size)</code>, para que las preferencias de usuario se usen para determinar el tamaño de los iconos.</p></item>
      <item><p><code>set_style(style)</code>, donde <code>style</code> es uno de <code>Gtk.ToolbarStyle.ICONS, Gtk.ToolbarStyle.TEXT, Gtk.ToolbarStyle.BOTH, Gtk.ToolbarStyle.BOTH_HORIZ</code>, determina si la barra de herramientas muestra solo iconos, solo texto, o ambos (apilados verticalmente o uno al lado de otro). Para dejar que las preferencias del usuario determinen el estilo de la barra de herramientas, y restablecer el estilo de barra de herramientas, use <code>unset_style()</code>.</p></item>
    </list>

  </section>

  <section id="reference">
    <title>Referencias de la API</title>
    <p>En este ejemplo se usa lo siguiente:</p>
    <list>
      <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkToolbar.html">GtkToolbar</link></p></item>
      <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkToolButton.html">GtkToolButton</link></p></item>
      <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkToolItem.html">GtkToolItem</link></p></item>
      <item><p><link href="http://developer.gnome.org/gtk3/unstable/gtk3-Stock-Items.html">Stock Items</link></p></item>
      <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkActionable.html">GtkActionable</link></p></item>
      <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkWidget.html">GtkWidget</link></p></item>
      <item><p><link href="http://developer.gnome.org/gdk3/unstable/gdk3-Event-Structures.html#GdkEventWindowState">Event Structures</link></p></item>
    </list>
  </section>
</page>
