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: