PyGTK - MenuBar, Menu e MenuItem
Uma barra horizontal logo abaixo da barra de título de um gtk.Window de nível superior é reservada para exibir uma série de menus. É um objeto da classe gtk.MenuBar na API PyGTK.
Um objeto da classe gtk.Menu é adicionado à barra de menus. Também é usado para criar menu de contexto e menu pop-up. Cada menu pode conter um ou mais widgets gtk.MenuItem. Alguns deles podem ser um submenu e têm botões MenuItem em cascata.
O gtk.MenuBar é uma subclasse da classe gtk.MenuShell. Ele tem um construtor padrão simples -
gtk.MenuBar()
Para adicionar um menu ao MenuBar, o método append () da classe MenuBar é usado.
Para construir um menu, crie um widget MenuItem com um rótulo que deseja que apareça na barra de menu e defina-o como um submenu.
Por exemplo, o código a seguir é usado para configurar um menu Arquivo -
menu1 = gtk.Menu()
file = gtk.MenuItem("_File")
file.set_submenu(menu1)
Agora, um ou mais widgets da classe MenuItem podem ser adicionados ao menu.
item1 = gtk.MenuItem("New")
item2 = gtk.MenuItem("Open")
Esses MenuItems são adicionados ao widget Menu e o objeto de menu, por sua vez, é adicionado à barra de menus.
menu1.append(item1)
menu1.append(item2)
mb.append(menu1)
O kit de ferramentas PyGTK oferece muitos tipos de widgets MenuItem. Um ImageMenuItem é um item de menu com uma imagem associada a ele. Você pode usar qualquer uma das imagens de estoque usando o parâmetro Stock ID ou atribuir qualquer outra imagem pelo método set_image ().
Por exemplo, o item de menu 'Novo' com imagem é criado da seguinte maneira -
new = gtk.ImageMenuItem(gtk.STOCK_NEW)
menu1.append(new)
Da mesma forma, também é possível adicionar CheckMenuItem usando o seguinte código -
chk = gtk.CheckMenuItem("Checkable")
menu1.append(chk)
Um grupo de itens de rádio também pode ser adicionado usando este código -
radio1 = gtk.RadioMenuItem(None,"Radio1")
radio2 = gtk.RadioMenuItem(radio1, "Radio2")
menu1.append(radio1)
menu1.append(radio2)
Às vezes, você pode querer adicionar uma linha separadora entre os itens do menu. Para esse efeito, oSeparatorMenuItem também está disponível.
sep = gtk.SeparatorMenuItem()
menu1.append(sep)
Você também pode atribuir atalhos de teclado a itens de menu. O PyGTK tem aceleradores. Comece criando um grupo de aceleradores e anexe-o à janela de nível superior.
acgroup = gtk.AccelGroup()
self.add_accel_group(acgroup)
Para atribuir um atalho, use add_accelerator() função com o seguinte protótipo -
Item1.add_accelerator(signal, group, key, modifier, flags)
A seguir estão alguns dos modificadores predefinidos -
- SHIFT_MASK
- LOCK_MASK
- CONTROL_MASK
- BUTTON1_MASK
- BUTTON1_MASK
Para atribuir o atalho Ctrl + N ao novo item do menu, use a seguinte sintaxe -
new = gtk.ImageMenuItem(gtk.STOCK_NEW,acgroup)
new.add_accelerator("activate", acgroup, ord('N'),
gtk.gdk.CONTROL_MASK, gtk.ACCEL_VISIBLE)
Exemplo
O exemplo a seguir demonstra os recursos discutidos acima -
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()
O código acima produzirá a seguinte saída -