Редактирование: PyGTK FAQ Menus

Материал из Wiki.crossplatform.ru

Перейти к: навигация, поиск
Внимание: Вы не представились системе. Ваш IP-адрес будет записан в историю изменений этой страницы.
Правка может быть отменена. Пожалуйста, просмотрите сравнение версий, чтобы убедиться, что это именно те изменения, которые вас интересуют, и нажмите «Записать страницу», чтобы изменения вступили в силу.
Текущая версия Ваш текст
Строка 1: Строка 1:
 +
In this part of the PyGTK programming tutorial, we will work with menus.
 +
A <b>menubar</b> is one of the most common parts of the GUI application. It is a group of commands located in various menus.
 +
While in console applications you have to remember all those arcane commands, here we have most of the commands grouped into logical parts. These are accepted standards that further reduce the amount of time spending to learn a new application.
 +
 +
== Simple menu ==
 +
In our first example, we will create a menubar with one file menu. The menu will have only one menu item. By selecting the item the application quits.
 +
<source lang="python">
 +
#!/usr/bin/python
 +
# ZetCode PyGTK tutorial
 +
#
 +
# This example shows a simple menu
 +
#
 +
# author: jan bodnar
 +
# website: zetcode.com
 +
# last edited: February 2009
 +
 +
import gtk
 +
 +
class PyApp(gtk.Window):
 +
 +
    def __init__(self):
 +
        super(PyApp, self).__init__()
 +
 +
        self.set_title("Simple menu")
 +
        self.set_size_request(250, 200)
 +
        self.modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(6400, 6400, 6440))
 +
        self.set_position(gtk.WIN_POS_CENTER)
 +
 +
        mb = gtk.MenuBar()
 +
 +
        filemenu = gtk.Menu()
 +
        filem = gtk.MenuItem("File")
 +
        filem.set_submenu(filemenu)
 +
     
 +
        exit = gtk.MenuItem("Exit")
 +
        exit.connect("activate", gtk.main_quit)
 +
        filemenu.append(exit)
 +
 +
        mb.append(filem)
 +
 +
        vbox = gtk.VBox(False, 2)
 +
        vbox.pack_start(mb, False, False, 0)
 +
 +
        self.add(vbox)
 +
 +
        self.connect("destroy", gtk.main_quit)
 +
        self.show_all()
 +
       
 +
       
 +
PyApp()
 +
gtk.main()
 +
</source>
 +
 +
This is a small example with minimal menubar functionality.
 +
 +
<source lang="python">
 +
mb = gtk.MenuBar()
 +
</source>
 +
 +
<b>MenuBar</b> widget is created.
 +
 +
<source lang="python">
 +
filemenu = gtk.Menu()
 +
filem = gtk.MenuItem("File")
 +
filem.set_submenu(filemenu)
 +
 +
</source>
 +
 +
Toplevel <b>MenuItem</b> is created.
 +
 +
<source lang="python">
 +
exit = gtk.MenuItem("Exit")
 +
exit.connect("activate", gtk.main_quit)
 +
filemenu.append(exit)
 +
</source>
 +
 +
Exit <b>MenuItem</b> is created and appended to the File <b>MenuItem</b>.
 +
 +
<source lang="python">
 +
mb.append(filem)
 +
</source>
 +
 +
Toplevel <b>MenuBar</b> widget.
 +
 +
<source lang="python">
 +
vbox = gtk.VBox(False, 2)
 +
vbox.pack_start(mb, False, False, 0)
 +
</source>
 +
 +
Unlike in other toolkits, we have to take care of the layout management of the menubar ourselves. We put the menubar into a vertical box.
 +
 +
[[image: pygtk_faq_simplemenu.png | center]]
 +
 +
== Image menu ==
 +
In the next example, we will further explore the menus. We will add images and accelerators to our menu items. <b>Accelerators</b> are keyboard shortcuts for activating a menu item.
 +
<source lang="python">
 +
#!/usr/bin/python
 +
# ZetCode PyGTK tutorial
 +
#
 +
# This example shows a menu with
 +
# images, accelerators and a separator
 +
#
 +
# author: jan bodnar
 +
# website: zetcode.com
 +
# last edited: February 2009
 +
 +
import gtk
 +
 +
class PyApp(gtk.Window):
 +
 +
    def __init__(self):
 +
        super(PyApp, self).__init__()
 +
 +
        self.set_title("Image menu")
 +
        self.set_size_request(250, 200)
 +
        self.modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(6400, 6400, 6440))
 +
        self.set_position(gtk.WIN_POS_CENTER)
 +
 +
        mb = gtk.MenuBar()
 +
 +
        filemenu = gtk.Menu()
 +
        filem = gtk.MenuItem("_File")
 +
        filem.set_submenu(filemenu)
 +
     
 +
        agr = gtk.AccelGroup()
 +
        self.add_accel_group(agr)
 +
 +
        newi = gtk.ImageMenuItem(gtk.STOCK_NEW, agr)
 +
        key, mod = gtk.accelerator_parse("<Control>N")
 +
        newi.add_accelerator("activate", agr, key,
 +
            mod, gtk.ACCEL_VISIBLE)
 +
        filemenu.append(newi)
 +
 +
        openm = gtk.ImageMenuItem(gtk.STOCK_OPEN, agr)
 +
        key, mod = gtk.accelerator_parse("<Control>O")
 +
        openm.add_accelerator("activate", agr, key,
 +
            mod, gtk.ACCEL_VISIBLE)
 +
        filemenu.append(openm)
 +
 +
        sep = gtk.SeparatorMenuItem()
 +
        filemenu.append(sep)
 +
 +
        exit = gtk.ImageMenuItem(gtk.STOCK_QUIT, agr)
 +
        key, mod = gtk.accelerator_parse("<Control>Q")
 +
        exit.add_accelerator("activate", agr, key,
 +
            mod, gtk.ACCEL_VISIBLE)
 +
 +
        exit.connect("activate", gtk.main_quit)
 +
       
 +
        filemenu.append(exit)
 +
 +
        mb.append(filem)
 +
 +
        vbox = gtk.VBox(False, 2)
 +
        vbox.pack_start(mb, False, False, 0)
 +
 +
        self.add(vbox)
 +
 +
        self.connect("destroy", gtk.main_quit)
 +
        self.show_all()
 +
       
 +
 +
PyApp()
 +
gtk.main()
 +
 +
</source>
 +
 +
Our example shows a toplevel menu item with three sublevel menu items. Each of the menu items has a image and an accelerator. The accelerator for the quit menu item is active.
 +
 +
<source lang="python">
 +
agr = gtk.AccelGroup()
 +
self.add_accel_group(agr)
 +
</source>
 +
 +
To work with accelerators, we create a global <b>AccelGroup</b> object. It will be used later. 
 +
 +
<source lang="python">
 +
newi = gtk.ImageMenuItem(gtk.STOCK_NEW, agr)
 +
</source>
 +
 +
<b>ImageMenuItem</b> is created. The image comes from the stock of images.
 +
 +
<source lang="python">
 +
key, mod = gtk.accelerator_parse("<Control>N")
 +
</source>
 +
 +
The <b>gtk.accelerator_parse()</b> function parses the specified accelerator string and returns a 2-tuple containing the keyval and modifier mask corresponding to accelerator.
 +
 +
<source lang="python">
 +
newi.add_accelerator("activate", agr, key,
 +
    mod, gtk.ACCEL_VISIBLE)
 +
</source>
 +
 +
This creates an Ctrl+Q accelerator for the exit menu item.
 +
 +
<source lang="python">
 +
sep = gtk.SeparatorMenuItem()
 +
filemenu.append(sep)
 +
</source>
 +
 +
These lines create a separator. It is used to group menu items into logical groups.
 +
 +
[[image: pygtk_faq_imagemenu.png | center]]
 +
 +
== CheckMenuItem ==
 +
A <b>CheckMenuItem</b> is a menu item with a check box. It can be used to work with boolean properties.
 +
<source lang="python">
 +
#!/usr/bin/python
 +
# ZetCode PyGTK tutorial
 +
#
 +
# This example shows how to
 +
# use a CheckMenuItem
 +
#
 +
# author: jan bodnar
 +
# website: zetcode.com
 +
# last edited: February 2009
 +
 +
import gtk
 +
 +
class PyApp(gtk.Window):
 +
 +
    def __init__(self):
 +
        super(PyApp, self).__init__()
 +
 +
        self.set_title("Check menu item")
 +
        self.set_size_request(250, 200)
 +
        self.modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(6400, 6400, 6440))
 +
        self.set_position(gtk.WIN_POS_CENTER)
 +
 +
        mb = gtk.MenuBar()
 +
 +
        filemenu = gtk.Menu()
 +
        filem = gtk.MenuItem("File")
 +
        filem.set_submenu(filemenu)
 +
     
 +
        viewmenu = gtk.Menu()
 +
        view = gtk.MenuItem("View")
 +
        view.set_submenu(viewmenu)
 +
 +
        stat = gtk.CheckMenuItem("View Statusbar")
 +
        stat.set_active(True)
 +
        stat.connect("activate", self.on_status_view)
 +
        viewmenu.append(stat)
 +
     
 +
        exit = gtk.MenuItem("Exit")
 +
        exit.connect("activate", gtk.main_quit)
 +
        filemenu.append(exit)
 +
 +
        mb.append(filem)
 +
        mb.append(view)
 +
 +
        self.statusbar = gtk.Statusbar()
 +
        self.statusbar.push(1, "Ready")
 +
 +
        vbox = gtk.VBox(False, 2)
 +
        vbox.pack_start(mb, False, False, 0)
 +
        vbox.pack_start(gtk.Label(), True, False, 0)
 +
        vbox.pack_start(self.statusbar, False, False, 0)
 +
 +
        self.add(vbox)
 +
 +
        self.connect("destroy", gtk.main_quit)
 +
        self.show_all()
 +
       
 +
       
 +
    def on_status_view(self, widget):
 +
        if widget.active:
 +
            self.statusbar.show()
 +
        else:
 +
            self.statusbar.hide()
 +
       
 +
 +
PyApp()
 +
gtk.main()
 +
</source>
 +
 +
In our code example we show a check menu item. If the check box is activated, the statusbar widget is shown. If not, the statusbar is hidden. 
 +
 +
<source lang="python">
 +
stat = gtk.CheckMenuItem("View Statusbar")
 +
</source>
 +
 +
<b>CheckMenuItem</b> widget is created.
 +
 +
<source lang="python">
 +
stat.set_active(True)
 +
</source>
 +
 +
The <b>set_active()</b> method checks/unchecks the check menu item.
 +
 +
<source lang="python">
 +
if widget.active:
 +
    self.statusbar.show()
 +
else:
 +
    self.statusbar.hide()
 +
</source>
 +
 +
Depending on the active property of the <b>CheckMenuItem</b>, we show or hide the statusbar widget.
 +
 +
[[image: pygtk_faq_checkmenuitem.png | center]]
 +
 +
== Submenu ==
 +
Our final example demonstrates how to create a submenu in PyGTK.
 +
<source lang="python">
 +
#!/usr/bin/python
 +
# ZetCode PyGTK tutorial
 +
#
 +
# This example shows a submenu
 +
#
 +
# author: jan bodnar
 +
# website: zetcode.com
 +
# last edited: February 2009
 +
 +
import gtk
 +
 +
class PyApp(gtk.Window):
 +
 +
    def __init__(self):
 +
        super(PyApp, self).__init__()
 +
 +
        self.set_title("Submenu")
 +
        self.set_size_request(250, 200)
 +
        self.modify_bg(gtk.STATE_NORMAL, gtk.gdk.Color(6400, 6400, 6440))
 +
        self.set_position(gtk.WIN_POS_CENTER)
 +
 +
        mb = gtk.MenuBar()
 +
 +
        filemenu = gtk.Menu()
 +
        filem = gtk.MenuItem("File")
 +
        filem.set_submenu(filemenu)
 +
     
 +
        mb.append(filem)
 +
       
 +
        imenu = gtk.Menu()
 +
 +
        importm = gtk.MenuItem("Import")
 +
        importm.set_submenu(imenu)
 +
 +
        inews = gtk.MenuItem("Import news feed...")
 +
        ibookmarks = gtk.MenuItem("Import bookmarks...")
 +
        imail = gtk.MenuItem("Import mail...")
 +
 +
        imenu.append(inews)
 +
        imenu.append(ibookmarks)
 +
        imenu.append(imail)
 +
 +
        filemenu.append(importm)
 +
 +
       
 +
        exit = gtk.MenuItem("Exit")
 +
        exit.connect("activate", gtk.main_quit)
 +
        filemenu.append(exit)
 +
 +
        vbox = gtk.VBox(False, 2)
 +
        vbox.pack_start(mb, False, False, 0)
 +
 +
        self.add(vbox)
 +
 +
        self.connect("destroy", gtk.main_quit)
 +
        self.show_all()
 +
     
 +
PyApp()
 +
gtk.main()
 +
</source>
 +
 +
Submenu creation.
 +
 +
<source lang="python">
 +
imenu = gtk.Menu()
 +
</source>
 +
 +
A submenu is a <b>Menu</b>.
 +
 +
<source lang="python">
 +
importm = gtk.MenuItem("Import")
 +
importm.set_submenu(imenu)
 +
</source>
 +
 +
It is a submenu of a menu item, which belogs to toplevel file menu.
 +
 +
<source lang="python">
 +
inews = gtk.MenuItem("Import news feed...")
 +
ibookmarks = gtk.MenuItem("Import bookmarks...")
 +
imail = gtk.MenuItem("Import mail...")
 +
 +
imenu.append(inews)
 +
imenu.append(ibookmarks)
 +
imenu.append(imail)
 +
</source>
 +
 +
Submenu has it's own menu items.
 +
 +
[[image: pygtk_faq_submenu.png | center]]
 +
 +
In this chapter of the PyGTK programming library, we showed, how to work with menus.
 +
 +
[[Категория:Python]]
 +
[[Категория:GTK+]]

Пожалуйста, обратите внимание, что все ваши добавления могут быть отредактированы или удалены другими участниками. Если вы не хотите, чтобы кто-либо изменял ваши тексты, не помещайте их сюда.
Вы также подтверждаете, что являетесь автором вносимых дополнений, или скопировали их из источника, допускающего свободное распространение и изменение своего содержимого (см. Wiki.crossplatform.ru:Авторское право). НЕ РАЗМЕЩАЙТЕ БЕЗ РАЗРЕШЕНИЯ ОХРАНЯЕМЫЕ АВТОРСКИМ ПРАВОМ МАТЕРИАЛЫ!