<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="button.py" xml:lang="es">

  <info>

    <title type="text">Botón (Python)</title>

    <link type="guide" xref="beginner.py#buttons"/>

    <link type="seealso" xref="signals-callbacks.py"/>

    <link type="next" xref="linkbutton.py"/>

    <revision version="0.2" date="2012-05-05" status="draft"/>

    <credit type="author copyright">

      <name>Marta Maria Casetti</name>

      <email its:translate="no">mmcasetti@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>Un widget de botón que emite una señal cuando se pulsa sobre él</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Daniel Mustieles</mal:name>

      <mal:email>daniel.mustieles@gmail.com</mal:email>

      <mal:years>2011 - 2017</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Nicolás Satragno</mal:name>

      <mal:email>nsatragno@gmail.com</mal:email>

      <mal:years>2012 - 2013</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Jorge González</mal:name>

      <mal:email>jorgegonz@svn.gnome.org</mal:email>

      <mal:years>2011</mal:years>

    </mal:credit>

  </info>

  <title>Button</title>

  <media type="image" mime="image/png" src="media/button.png"/>

  
Un widget de botón conectado a una función de retorno de llamada.

  <links type="section"/>

  <section id="code">

    <title>Código usado para generar este ejemplo</title>

    from gi.repository import Gtk

import sys

class MyWindow(Gtk.ApplicationWindow):

    # a window

    def __init__(self, app):

        Gtk.Window.__init__(self, title="GNOME Button", application=app)

        self.set_default_size(250, 50)

        # a button

        button = Gtk.Button()

        # with a label

        button.set_label("Click me")

        # connect the signal "clicked" emitted by the button

        # to the callback function do_clicked

        button.connect("clicked", self.do_clicked)

        # add the button to the window

        self.add(button)

    # callback function connected to the signal "clicked" of the button

    def do_clicked(self, button):

        print("You clicked me!")

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        win.show_all()

    def do_startup(self):

        Gtk.Application.do_startup(self)

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

  </section>

  <section id="methods">

    <title>Métodos útiles para un widget «Button»</title>

    
En la línea 16, la señal «clicked» del botón se conecta a la función de retorno de llamada do_clicked() usando widget.connect(señal, función de retorno de llamada). Consulte la <link xref="signals-callbacks.py"/> para obtener una explicación más detallada.

    <list>

      <item>
set_relief(Gtk.ReliefStyle.NONE) establece el estilo de relieve de los bordes del «Gtk.Button» a «ninguno», opuesto a Gtk.ReliefStyle.NORMAL.
</item>

      <item>
Si la etiqueta de un botón es un <link href="http://developer.gnome.org/gtk3/unstable/gtk3-Stock-Items.html">icono del almacén</link>, set_use_stock(True) establece la etiqueta al nombre del icono del almacén correspondiente.
</item>

      <item>
Para establecer una imagen (por ejemplo, una imagen del almacén) para el botón button:

image = Gtk.Image()

image.set_from_stock(Gtk.STOCK_ABOUT, Gtk.IconSize.BUTTON)

button.set_image(image)

      
No debe establecer una etiqueta para el botón después de esto, ya que si lo hace mostrará la etiqueta y no la imagen.
</item>

      <item>
Si usa set_focus_on_click(False), el botón no atrapará el foco cuando el ratón lo pulse. Esto podría ser útil en lugares como barras de herramientas, para que el foco del teclado no se quite del área principal de la aplicación.
</item>

    </list>

  </section>

  <section id="references">

    <title>Referencias de la API</title>

    
En este ejemplo se usa lo siguiente:

    <list>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkButton.html">GtkButton</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkWindow.html">GtkWindow</link>
</item>

    </list>

  </section>

</page>