|
Packit |
1470ea |
|
|
Packit |
1470ea |
<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="gmenu.py" xml:lang="es">
|
|
Packit |
1470ea |
<info>
|
|
Packit |
1470ea |
<title type="text">GMenu (Python)</title>
|
|
Packit |
1470ea |
<link type="guide" xref="beginner.py#menu-combo-toolbar"/>
|
|
Packit |
1470ea |
<link type="seealso" xref="signals-callbacks.py"/>
|
|
Packit |
1470ea |
<link type="next" xref="menubutton.py"/>
|
|
Packit |
1470ea |
<revision version="0.1" date="2012-04-28" status="draft"/>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<credit type="author copyright">
|
|
Packit |
1470ea |
<name>Tiffany Antopolski</name>
|
|
Packit |
1470ea |
<email its:translate="no">tiffany.antopolski@gmail.com</email>
|
|
Packit |
1470ea |
<years>2012</years>
|
|
Packit |
1470ea |
</credit>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<credit type="author copyright">
|
|
Packit |
1470ea |
<name>Marta Maria Casetti</name>
|
|
Packit |
1470ea |
<email its:translate="no">mmcasetti@gmail.com</email>
|
|
Packit |
1470ea |
<years>2012</years>
|
|
Packit |
1470ea |
</credit>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<desc>Una implementación sencilla de GMenu</desc>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
|
|
Packit |
1470ea |
<mal:name>Daniel Mustieles</mal:name>
|
|
Packit |
1470ea |
<mal:email>daniel.mustieles@gmail.com</mal:email>
|
|
Packit |
1470ea |
<mal:years>2011 - 2017</mal:years>
|
|
Packit |
1470ea |
</mal:credit>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
|
|
Packit |
1470ea |
<mal:name>Nicolás Satragno</mal:name>
|
|
Packit |
1470ea |
<mal:email>nsatragno@gmail.com</mal:email>
|
|
Packit |
1470ea |
<mal:years>2012 - 2013</mal:years>
|
|
Packit |
1470ea |
</mal:credit>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
|
|
Packit |
1470ea |
<mal:name>Jorge González</mal:name>
|
|
Packit |
1470ea |
<mal:email>jorgegonz@svn.gnome.org</mal:email>
|
|
Packit |
1470ea |
<mal:years>2011</mal:years>
|
|
Packit |
1470ea |
</mal:credit>
|
|
Packit |
1470ea |
</info>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<title>GMenu</title>
|
|
Packit |
1470ea |
<media type="image" mime="image/png" src="media/gmenu.py.png"/>
|
|
Packit |
1470ea |
Una GtkApplication con un GMenu sencillo y SimpleActions
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<links type="section"/>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="code">
|
|
Packit |
1470ea |
<title>Código usado para generar este ejemplo</title>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
from gi.repository import Gtk
|
|
Packit |
1470ea |
from gi.repository import Gio
|
|
Packit |
1470ea |
import sys
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
class MyWindow(Gtk.ApplicationWindow):
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def __init__(self, app):
|
|
Packit |
1470ea |
Gtk.Window.__init__(self, title="GMenu Example", application=app)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
class MyApplication(Gtk.Application):
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def __init__(self):
|
|
Packit |
1470ea |
Gtk.Application.__init__(self)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def do_activate(self):
|
|
Packit |
1470ea |
win = MyWindow(self)
|
|
Packit |
1470ea |
win.show_all()
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
def do_startup(self):
|
|
Packit |
1470ea |
# start the application
|
|
Packit |
1470ea |
Gtk.Application.do_startup(self)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# create a menu
|
|
Packit |
1470ea |
menu = Gio.Menu()
|
|
Packit |
1470ea |
# append to the menu three options
|
|
Packit |
1470ea |
menu.append("New", "app.new")
|
|
Packit |
1470ea |
menu.append("About", "app.about")
|
|
Packit |
1470ea |
menu.append("Quit", "app.quit")
|
|
Packit |
1470ea |
# set the menu as menu of the application
|
|
Packit |
1470ea |
self.set_app_menu(menu)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# create an action for the option "new" of the menu
|
|
Packit |
1470ea |
new_action = Gio.SimpleAction.new("new", None)
|
|
Packit |
1470ea |
# connect it to the callback function new_cb
|
|
Packit |
1470ea |
new_action.connect("activate", self.new_cb)
|
|
Packit |
1470ea |
# add the action to the application
|
|
Packit |
1470ea |
self.add_action(new_action)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# option "about"
|
|
Packit |
1470ea |
about_action = Gio.SimpleAction.new("about", None)
|
|
Packit |
1470ea |
about_action.connect("activate", self.about_cb)
|
|
Packit |
1470ea |
self.add_action(about_action)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# option "quit"
|
|
Packit |
1470ea |
quit_action = Gio.SimpleAction.new("quit", None)
|
|
Packit |
1470ea |
quit_action.connect("activate", self.quit_cb)
|
|
Packit |
1470ea |
self.add_action(quit_action)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# callback function for "new"
|
|
Packit |
1470ea |
def new_cb(self, action, parameter):
|
|
Packit |
1470ea |
print("This does nothing. It is only a demonstration.")
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# callback function for "about"
|
|
Packit |
1470ea |
def about_cb(self, action, parameter):
|
|
Packit |
1470ea |
print("No AboutDialog for you. This is only a demonstration.")
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
# callback function for "quit"
|
|
Packit |
1470ea |
def quit_cb(self, action, parameter):
|
|
Packit |
1470ea |
print("You have quit.")
|
|
Packit |
1470ea |
self.quit()
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
app = MyApplication()
|
|
Packit |
1470ea |
exit_status = app.run(sys.argv)
|
|
Packit |
1470ea |
sys.exit(exit_status)
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="methods">
|
|
Packit |
1470ea |
<title>Métodos útiles para una «GSimpleAction» y un GMenu</title>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
En la línea 33, la señal «activate» de la acción new_action (no el menú) se conecta a la función de retorno de llamada new_cb() usando action.connect(señal, función de retorno de llamada) . Consulte la <link xref="signals-callbacks.py"/> para obtener una explicación más detallada.
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
Métodos útiles para una «GSimpleAction»:
|
|
Packit |
1470ea |
<list>
|
|
Packit |
1470ea |
<item>Para crear una acción nueva que no dependa del estado, es decir, una acción que no retenga o dependa de un estado dado a la acción en sí, use
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
action = Gio.SimpleAction.new("name", parameter_type)
|
|
Packit |
1470ea |
donde "name" es el nombre de la acción y parameter_type es el tipo de parámetro que recibe la acción cuando se activa. Este puede ser None , o GLib.VariantType.new('s') si el parámetro es del tipo str , o en lugar de 's' un carácter como se describe <link href="http://developer.gnome.org/glib/unstable/glib-GVariantType.html">aquí</link>. Para crear una acción nueva con estado, use
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
action = Gio.SimpleAction.new_stateful("name", parameter_type, initial_state)
|
|
Packit |
1470ea |
donde initial_state está definido como una GVariant: por ejemplo Glib.Variant.new_string('start') ; para una lista de posibilidades consulte <link href="http://developer.gnome.org/glib/unstable/glib-GVariant.html">aquí</link>. </item>
|
|
Packit |
1470ea |
<item>set_enabled(True) configura la acción como habilitada; una acción debe habilitarse para poder activarse o para que llamantes exteriores cambien su estado. Sólo el que implementa la acción debe llamarlo. Los usuarios de la acción no deben intentar modificar su opción «enabled». </item>
|
|
Packit |
1470ea |
<item>set_state(estado) , donde estado es una GVariant, establece el estado de la acción, actualizando la propiedad «state» a un valor dado. Sólo el que implementa la acción debe llamarlo; los usuarios de la acción, en cambio, deben llamar a change_state(estado) (donde estado es como se mencionó) para solicitar el cambio. </item>
|
|
Packit |
1470ea |
</list>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
Métodos útiles para un GMenu:
|
|
Packit |
1470ea |
<list>
|
|
Packit |
1470ea |
<item>Para insertar un elemento en el menú en una posición , use insert(posición, etiqueta, acción_detallada) , donde etiqueta es la etiqueta que aparecerá en el menú y acción_detallada es una cadena compuesta por el nombre de la acción a la que se la agrega el prefijo app. . Puede encontrar una discusión más detallada de esto en la <link xref="menubar.py#win-app"/>.
|
|
Packit |
1470ea |
Para agregar o anteponer un elemento en el menú use respectivamente append(etiqueta, acción_detallada) y prepend(etiqueta, acción_detallada) . </item>
|
|
Packit |
1470ea |
<item>Otra manera de añadir elementos al menú es crearlos como GMenuItem y usar insert_item(posición, elemento) , append_item(elemento) , o prepend_item(elemento) ; por lo que por ejemplo se podría tener:
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
about = Gio.MenuItem.new("About", "app.about")
|
|
Packit |
1470ea |
menu.append_item(about)
|
|
Packit |
1470ea |
</item>
|
|
Packit |
1470ea |
<item>También se puede añadir una subsección completa a un menú usando insert_section(posición, etiqueta, sección) , append_section(etiqueta, sección) , o prepend_section(etiqueta, sección) , donde etiqueta es el título de la subsección. </item>
|
|
Packit |
1470ea |
<item>Para añadir un submenú que se expanda y colapse, use insert_submenu(posición, etiqueta, sección) , append_submenu(etiqueta, sección) , o prepend_submenu(etiqueta, sección) , donde etiqueta es el título de la subsección. </item>
|
|
Packit |
1470ea |
<item>Para eliminar un elemento del menú, use remove(posición) . </item>
|
|
Packit |
1470ea |
<item>Para establecer una etiqueta para el menú, use set_label(etiqueta) . </item>
|
|
Packit |
1470ea |
</list>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
|
|
Packit |
1470ea |
<section id="references">
|
|
Packit |
1470ea |
<title>Referencias de la API</title>
|
|
Packit |
1470ea |
En este ejemplo se usa lo siguiente:
|
|
Packit |
1470ea |
<list>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gio/unstable/GMenu.html">GMenu</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/gio/stable/GSimpleAction.html">GSimpleAction</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/glib/unstable/glib-GVariantType.html">GVariantType</link> </item>
|
|
Packit |
1470ea |
<item><link href="http://developer.gnome.org/glib/unstable/glib-GVariant.html">GVariant</link> </item>
|
|
Packit |
1470ea |
</list>
|
|
Packit |
1470ea |
</section>
|
|
Packit |
1470ea |
</page>
|