<?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="progressbar.py" xml:lang="es">
  <info>
    <title type="text">ProgressBar (Python)</title>
    <link type="guide" xref="beginner.py#display-widgets"/>
    <revision version="0.2" date="2012-06-12" status="draft"/>

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

    <desc>Un widget que indica el progreso de manera visual.</desc>
  </info>

  <title>ProgressBar</title>
  <media type="video" mime="application/ogv" src="media/progressbar.ogv">
    <tt:tt xmlns:tt="http://www.w3.org/ns/ttml">
      <tt:body>
        <tt:div begin="0s" end="6s">
          <p>Pulsar cualquier tecla detiene e inicia esta ProgressBar.</p>
        </tt:div>
      </tt:body>
    </tt:tt>
  </media>
  <p>La ProgressBar se detiene y se inicia pulsando una tecla.</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/progressbar.py" parse="text"><xi:fallback/></xi:include></code>

  </section>

  <section id="methods">
  <title>Métodos útiles para un widget «ProgressBar»</title>
  <list>
    <item><p>En lugar de <code>pulse()</code>, que hace que la barra avance y retroceda, si se quiere que la barra de progreso «llene» una fracción (un <code>float</code> entre <code>0.0</code> y <code>1.0</code> inclusive) de la barra que se ha completado, use <code>set_fraction(fracción)</code>.</p></item>
    <item><p>Para establecer un texto y mostrarlo (superpuesto a la barra) use <code>set_text("texto")</code> y <code>set_show_text(True)</code>. Si no se establece un texto y <code>set_show_text(True)</code>, el texto será el porcentaje del trabajo que se ha completado.</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/GtkProgressBar.html">GtkProgressBar</link></p></item>
    <item><p><link href="http://developer.gnome.org/glib/stable/glib-The-Main-Event-Loop.html">GLib - The Main Event Loop</link></p></item>
    <item><p><link href="http://developer.gnome.org/gdk/stable/gdk-Keyboard-Handling">Gdk - Key Values</link></p></item>
  </list>
  </section>
</page>
