Siguiendo la tradición docente pura, primero te enseñaremos la forma difícil. :)

Hay tres controles involucrados en la creación de una barra de menús y de submenús:

Esto es algo complicado por el hecho de que los controles de elementos de menú se usan para dos cosas distintas. Son tanto los controles que se colocan en el menú, y el control que se coloca en la barra de menú, que, cuando se selecciona, activa el menú.

Veamos las funciones que se usan para crear menús y barras de menús. La primera función se usa para crear una nueva barra de menú:

  menu_bar = gtk.MenuBar()

Esta función bastante autoexplicativa crea una nueva barra de menús. Puedes usar el método add() de GtkContainer para meter la barra de menús en una ventana, o los métodos pack de GtkBox para meterlo en una caja - igual que los botones.

  menu = gtk.Menu()

Esta función devuelve una referencia a un nuevo menú; nunca se mostrará (con el método show() ), es sólo un contenedor para los elementos de menús. Espero que esto se aclare un poco cuando veas el ejemplo más abajo.

La siguiente función se usa para crear elementos de menús que se colocan en el menú (y la barra de menús):

  menu_item = gtk.MenuItem(label=None)

El parámetro label, si existe, se analizará buscando caracteres mnemónicos. Esta llamada se usa para crear elementos de menú que se van a visualizar. Acuerdate de diferenciar entre un "menú" como el que creas con gtk.Menu() y un "elemento de menú" como el que creas con gtk.MenuItem() . El elemento de menú será en realidad un botón con una acción asociada, mientras que un menú será un contenedor que contiene elementos de menú.

Una vez que has creado un elemento de menú tienes que meterlo en un menú. Esto se consigue con el método append() . Para poder saber cuándo el usuario selecciona un elemento, necesitamos conectarlo a la señal "activate" de la forma habitual. Por tanto, si queremos crear un menú estándard Archivo , con las opciones Abrir, Guardar, y Salir, el código sería algo asi como:

  file_menu = gtk.Menu()    # Don't need to show menus

  # Create the menu items
  open_item = gtk.MenuItem("Abrir")
  save_item = gtk.MenuItem("Guardar")
  quit_item = gtk.MenuItem("Salir")

  # Add them to the menu
  file_menu.append(open_item)
  file_menu.append(save_item)
  file_menu.append(quit_item)

  # Conecta las funciones de retrollamada a la señal "activate"
  open_item.connect_object("activate", menuitem_response, "file.open")
  save_item.connect_object("activate", menuitem_response, "file.save")

  # conectamos el elemento quit a nuestra función de salida
  quit_item.connect_object ("activate", destroy, "file.quit")

  # necesitamos mostrar los elementos de menú
  open_item.show()
  save_item.show()
  quit_item.show()

En este punto tenemos nuestro menú. Ahora necesitamos crear una barra de menú y un elemento de menú para la entrada Archivo , que añadiremos a nuestro menú. El código es el siguiente:

  menu_bar = gtk.MenuBar()
  window.add(menu_bar)
  menu_bar.show()

  file_item = gtk.MenuItem("Archivo")
  file_item.show()

Ahora necesitamos asociar el menú con file_item. Esto se hace con el método:

  menu_item.set_submenu(submenu)

Por tanto, nuestro ejemplo continúa asi:

  menu_item.set_submenu(file_menu)

Lo único que nos queda es añadir el menú a la barra de menús, lo cual se consigue con el método:

  menu_bar.append(child)

que en nuestro caso es así:

  menu_bar.append(file_item)

Si queremos el menú justificado a la derecha en la barra de menús, como los menús de ayuda, podemos usar el siguiente método (de nuevo en file_item en nuestro ejemplo) antes de añadirlo a la barra de menús.

  menu_item.set_right_justified(right_justified)

Aqui tienes un resumen de los pasos necesarios para crear una barra de menús con menús en ella:

Crear un menú emergente es casi lo mismo. La diferencia es que el menú no se visualiza "automáticamente" por una barra de menús, sino explícitamente llamando al método popup() desde un evento de pulsación de botón, por ejemplo. Sigue estos pasos: