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 -