PyGTK - MenuBar, Menu e MenuItem

Una barra orizzontale appena sotto la barra del titolo di un gtk di livello superiore. La finestra è riservata alla visualizzazione di serie di menu. È un oggetto della classe gtk.MenuBar nell'API PyGTK.

Un oggetto della classe gtk.Menu viene aggiunto alla barra dei menu. Viene anche utilizzato per creare menu contestuali e menu popup. Ogni menu può contenere uno o più widget gtk.MenuItem. Alcuni di essi possono essere sottomenu e avere pulsanti MenuItem a cascata.

Gtk.MenuBar è una sottoclasse della classe gtk.MenuShell. Ha un semplice costruttore predefinito -

gtk.MenuBar()

Per aggiungere un menu a MenuBar, viene utilizzato il metodo append () della classe MenuBar.

Per costruire un menu, creare un widget MenuItem con un'etichetta che si desidera appaia nella barra dei menu e impostarla come sottomenu.

Ad esempio, il codice seguente viene utilizzato per impostare un menu File:

menu1 = gtk.Menu()
file = gtk.MenuItem("_File")
file.set_submenu(menu1)

Ora è possibile aggiungere uno o più widget della classe MenuItem nel menu.

item1 = gtk.MenuItem("New")
item2 = gtk.MenuItem("Open")

Questi MenuItem vengono aggiunti al widget Menu e l'oggetto menu a sua volta viene aggiunto alla barra dei menu.

menu1.append(item1)
menu1.append(item2)
mb.append(menu1)

Il toolkit PyGTK offre molti tipi di widget MenuItem. Un ImageMenuItem è una voce di menu a cui è associata un'immagine. È possibile utilizzare qualsiasi immagine stock utilizzando il parametro Stock ID o assegnare qualsiasi altra immagine con il metodo set_image ().

Ad esempio, la voce di menu "Nuovo" con immagine viene creata nel modo seguente:

new = gtk.ImageMenuItem(gtk.STOCK_NEW)
menu1.append(new)

Allo stesso modo, è anche possibile aggiungere CheckMenuItem utilizzando il codice seguente:

chk = gtk.CheckMenuItem("Checkable")
menu1.append(chk)

È anche possibile aggiungere un gruppo di elementi radio utilizzando questo codice:

radio1 = gtk.RadioMenuItem(None,"Radio1")
radio2 = gtk.RadioMenuItem(radio1, "Radio2")
menu1.append(radio1)
menu1.append(radio2)

A volte, potresti voler aggiungere una linea di separazione tra le voci di menu. A tale scopo, ilSeparatorMenuItem è anche disponibile.

sep = gtk.SeparatorMenuItem()
menu1.append(sep)

Puoi anche assegnare scorciatoie da tastiera alle voci di menu. PyGTK ha acceleratori. Inizia creando un gruppo di acceleratori e collegalo alla finestra di primo livello.

acgroup = gtk.AccelGroup()
self.add_accel_group(acgroup)

Per assegnare la scorciatoia, usa add_accelerator() funzione con il seguente prototipo:

Item1.add_accelerator(signal, group, key, modifier, flags)

I seguenti sono alcuni dei modificatori predefiniti:

  • SHIFT_MASK
  • LOCK_MASK
  • CONTROL_MASK
  • BUTTON1_MASK
  • BUTTON1_MASK

Per assegnare la scorciatoia Ctrl + N alla voce Nuovo menu, utilizzare la seguente sintassi:

new = gtk.ImageMenuItem(gtk.STOCK_NEW,acgroup)
new.add_accelerator("activate", acgroup, ord('N'), 
   gtk.gdk.CONTROL_MASK, gtk.ACCEL_VISIBLE)

Esempio

L'esempio seguente mostra le funzionalità discusse sopra:

import gtk

class PyApp(gtk.Window):
   def __init__(self):
      
      super(PyApp, self).__init__()
      self.set_title("Menu Demo")
      self.set_default_size(250, 200)
      self.set_position(gtk.WIN_POS_CENTER)
      
      mb = gtk.MenuBar()
      
	  menu1 = gtk.Menu()
      file = gtk.MenuItem("_File")
      file.set_submenu(menu1)
      acgroup = gtk.AccelGroup()
      self.add_accel_group(acgroup)
      new = gtk.ImageMenuItem(gtk.STOCK_NEW,acgroup)
      new.add_accelerator("activate", acgroup, ord('N'), 
         gtk.gdk.CONTROL_MASK, gtk.ACCEL_VISIBLE)
      
      menu1.append(new)
      open = gtk.ImageMenuItem(gtk.STOCK_OPEN)
      
      menu1.append(open)
      chk = gtk.CheckMenuItem("Checkable")
      
      menu1.append(chk)
      radio1 = gtk.RadioMenuItem(None,"Radio1")
      radio2 = gtk.RadioMenuItem(radio1, "Radio2")
      
      menu1.append(radio1)
      menu1.append(radio2)
      sep = gtk.SeparatorMenuItem()
      
      menu1.append(sep)
      exit = gtk.ImageMenuItem(gtk.STOCK_QUIT)
      
      menu1.append(exit)
      menu2 = gtk.Menu()
      edit = gtk.MenuItem("_Edit")
      edit.set_submenu(menu2)
      copy = gtk.ImageMenuItem(gtk.STOCK_COPY)
      
      menu2.append(copy)
      cut = gtk.ImageMenuItem(gtk.STOCK_CUT)
      
      menu2.append(cut)
      paste = gtk.ImageMenuItem(gtk.STOCK_PASTE)
      
      menu2.append(paste)
      mb.append(file)
      mb.append(edit)
      vbox = gtk.VBox(False, 2)
      vbox.pack_start(mb, False, False, 0)
      
      self.add(vbox)
      self.connect("destroy", gtk.main_quit)
      self.show_all()
if __name__ == '__main__':
   PyApp()
   gtk.main()

Il codice precedente produrrà il seguente output: