PyGTK - pasek menu, menu i element menu
Poziomy pasek tuż pod paskiem tytułowym górnego poziomu gtk.Window jest zarezerwowany do wyświetlania serii menu. Jest to obiekt klasy gtk.MenuBar w PyGTK API.
Do paska menu dodawany jest obiekt klasy gtk.Menu. Służy również do tworzenia menu kontekstowego i menu podręcznego. Każde menu może zawierać jeden lub więcej widżetów gtk.MenuItem. Niektóre z nich mogą być podmenu i mieć kaskadowe przyciski MenuItem.
Klasa gtk.MenuBar jest podklasą klasy gtk.MenuShell. Ma prostego domyślnego konstruktora -
gtk.MenuBar()
Aby dodać menu do MenuBar, używana jest metoda append () klasy MenuBar.
Aby zbudować menu, utwórz widżet MenuItem z etykietą, która ma pojawić się na pasku menu i ustaw ją jako podmenu.
Na przykład poniższy kod służy do konfigurowania menu Plik -
menu1 = gtk.Menu()
file = gtk.MenuItem("_File")
file.set_submenu(menu1)
Teraz w menu można dodać jeden lub więcej widżetów klasy MenuItem.
item1 = gtk.MenuItem("New")
item2 = gtk.MenuItem("Open")
Te elementy MenuItem są dodawane do widżetu Menu, a obiekt menu jest z kolei dodawany do paska menu.
menu1.append(item1)
menu1.append(item2)
mb.append(menu1)
Zestaw narzędzi PyGTK oferuje wiele typów widżetów MenuItem. ImageMenuItem to element menu ze skojarzonym z nim obrazem. Możesz użyć dowolnego obrazu stockowego, używając parametru Stock ID lub przypisać dowolny inny obraz za pomocą metody set_image ().
Na przykład pozycja menu „Nowa” z obrazem jest tworzona w następujący sposób -
new = gtk.ImageMenuItem(gtk.STOCK_NEW)
menu1.append(new)
Podobnie możliwe jest również dodanie CheckMenuItem przy użyciu następującego kodu -
chk = gtk.CheckMenuItem("Checkable")
menu1.append(chk)
Za pomocą tego kodu można również dodać grupę elementów radiowych -
radio1 = gtk.RadioMenuItem(None,"Radio1")
radio2 = gtk.RadioMenuItem(radio1, "Radio2")
menu1.append(radio1)
menu1.append(radio2)
Czasami możesz chcieć dodać linię separatora między elementami menu. W tym celuSeparatorMenuItem jest również dostępna.
sep = gtk.SeparatorMenuItem()
menu1.append(sep)
Do elementów menu można także przypisywać skróty klawiaturowe. PyGTK ma akceleratory. Zacznij od utworzenia grupy akceleratorów i dołącz ją do okna najwyższego poziomu.
acgroup = gtk.AccelGroup()
self.add_accel_group(acgroup)
Aby przypisać skrót, użyj add_accelerator() funkcja z następującym prototypem -
Item1.add_accelerator(signal, group, key, modifier, flags)
Oto niektóre z predefiniowanych modyfikatorów -
- SHIFT_MASK
- LOCK_MASK
- CONTROL_MASK
- BUTTON1_MASK
- BUTTON1_MASK
Aby przypisać skrót Ctrl + N do nowej pozycji menu, użyj następującej składni -
new = gtk.ImageMenuItem(gtk.STOCK_NEW,acgroup)
new.add_accelerator("activate", acgroup, ord('N'),
gtk.gdk.CONTROL_MASK, gtk.ACCEL_VISIBLE)
Przykład
Poniższy przykład demonstruje funkcje omówione powyżej -
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()
Powyższy kod wygeneruje następujący wynik -