<?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="spinbutton.py" xml:lang="es">
  <info>
    <title type="text">SpinButton (Python)</title>
    <link type="guide" xref="beginner.py#entry"/>
    <link type="seealso" xref="grid.py"/>
    <revision version="0.2" date="2012-06-23" status="draft"/>

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

    <desc>Obtener un número entero o en coma flotante del usuario.</desc>
  </info>

  <title>SpinButton</title>
  <media type="image" mime="image/png" src="media/spinbutton.png"/>
  <p>Elija un número, escribiéndolo o pulsando los botones -/+.</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/spinbutton.py" parse="text"><xi:fallback/></xi:include></code>
  </section>

  <section id="methods">
    <title>Métodos útiles para un widget «SpinButton»</title>
    <p>Para una explicación de señales y de funciones de devolución de llamada, consulte <link xref="signals-callbacks.py">esta página</link>. Un ejemplo es la señal <code>"value-changed"</code>, emitida cuando el cambia el valor del botón incremental.</p>
    <p>Se necesita un «Gtk.Adjustment» para construir el «Gtk.SpinButton». Este es la representación de un valor con un límite superior e inferior, junto con pasos y páginas de incrementos, y un tamaño de página, y se construye como <code>Gtk.Adjustment(valor, mínimo, ,máximo, paso, página, tamaño_de_página)</code> donde los campos son del tipo <code>float</code>; <code>paso</code> es el incremento/decremento que se obtiene usando las teclas de dirección o los botones del botón incremental. Tenga en cuenta que <code>página</code> y <code>tamaño_de_página</code> no se usan en este caso, y deben establecerse a <code>0</code>.</p>
    <list>
      <item><p>Si quiere que el valor del botón incremental dé la vuelta cuando exceda el máximo o el mínimo, establezca <code>set_wrap(True)</code>. La señal <code>"wrapped"</code> se emite cuando esto sucede.</p></item>
      <item><p><code>set_digits(dígitos)</code> establece la precisión que muestra el botón incremental, hasta 20 dígitos.</p></item>
      <item><p>Para obtener el valor del botón incremental como un entero, use <code>get_value_as_int()</code>.</p></item>
    </list>
  </section>

  <section id="references">
    <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/GtkSpinButton.html">GtkSpinButton</link></p></item>
      <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkAdjustment.html">GtkAdjustment</link></p></item>
    </list>
  </section>
</page>
