Menus and Toolbars選單與工具欄

 A common part in a GUI application is a menubar. A menubar consists of objects called menus. Top-level menus have their labels on the menubar. The menus have menu items. Menu items are commands that perform a specific action inside the application. Menus can also have submenus, which have their own menu items. The following three classes are used to create menubars in wxPython. A wx.MenuBar, a wx.Menu and a wx.MenuItem.

一個選單包括選單的物件。頂層選單有選單欄上的標籤。選單選單項。選單項命令執行一個應用程式內的具體行動。選單中還可以有子選單，其中有自己的選單項。以下三個類用於建立在wxPython的選單欄。一個wx.MenuBar，wx.Menu和wx.MenuItem。

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.

在我們的第一個例子中,我們將建立一個menubar,一個檔案選單。選單將只有一個選單項。通過選擇項應用程式退出。

import wx
class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
    def InitUI(self):
        menuBar = wx.MenuBar()
        filemenu = wx.Menu()
        
        fitem = filemenu.Append(wx.ID_EXIT,"Quit","Quit Applications")
        menuBar.Append(filemenu,"&File")
        self.SetMenuBar(menuBar)
        
        self.Bind(wx.EVT_MENU, self.OnQuit, fitem)
        
        self.SetSize((400,250))
        self.SetTitle("SimpleMenu")
        #self.Centre()
        self.Center()
        self.Show()
    def OnQuit(self,e):
        self.Close()
    
def main():
    ex = wx.App()
    Example(None)
    ex.MainLoop()
if __name__ == '__main__':
    main()
 

這是一個以最小的選單功能小例子。

menubar = wx.MenuBar()首先我們建立一個menubar物件。

fileMenu = wx.Menu()接下來,我們建立一個選單物件。

fitem = fileMenu.Append(wx.ID_EXIT, 'Quit', 'Quit application')

我們追加到選單項的選單物件。第一個引數是選單項的ID。標準ID會自動新增一個圖示和快捷。 CTRL + Q在我們的例子。第二個引數是選單項的名稱。最後一個引數定義狀態列上顯示的選單項被選中時，簡短的幫助字串。在這裡，我們沒有創造出wx.MenuItem明確。它是幕後的append（）方法建立。該方法返回建立的選單項。此參考將使用後繫結事件。

self.Bind(wx.EVT_MENU, self.OnQuit, fitem)

我們繫結選單項wx.EVT_MENU的的的定製OnQuit（）方法。這種方法將關閉應用程式。

menubar.Append(fileMenu, '&File')
self.SetMenuBar(menubar)

之後，我們追加到選單欄選單。 ＆字元建立一個快捷鍵。後面的字元下劃線。這種方式是通過按Alt + F快捷訪問選單。最後，我們呼籲的SetMenuBar（）方法。這種方法屬於wx.Frame的部件。它設定的選單欄。

Icons and shortcuts圖示與快捷鍵

 The next example is esencially the same as the previous one. This time, we manually create a wx.MenuItem.

在下一個例子基本上是與前一個相同。這一次，我們手動建立一個wx.MenuItem。

import wx

APP_EXIT = 1

class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
    def InitUI(self):
        menuBar = wx.MenuBar()
        filemenu = wx.Menu()
        
        qmi = wx.MenuItem(filemenu,APP_EXIT,"&Quit\tCtrl+Q")
        qmi.SetBitmap(wx.Bitmap("exit.png"))
        filemenu.AppendItem(qmi)
        
        self.Bind(wx.EVT_MENU, self.OnQuit, id=APP_EXIT)

        menuBar.Append(filemenu, '&File')
        self.SetMenuBar(menuBar)
        
        self.SetSize((250, 200))
        self.SetTitle('Icons and shortcuts')
        self.Centre()
        self.Show(True)
    def OnQuit(self, e):
        self.Close()

def main():
    ex = wx.App()
    Example(None)
    ex.MainLoop()
if __name__ == '__main__':
    main()

在本例中,我們建立一個退出選單項。我們選擇了一個自定義圖示和選單項的快捷方式。 qmi = wx.MenuItem(fileMenu, APP_EXIT, '&Quit\tCtrl+Q')
qmi.SetBitmap(wx.Bitmap('exit.png'))
fileMenu.AppendItem(qmi)
我們建立wx.MenuItem物件。 ＆字元指定一個快捷鍵。強調符號字元。實際的快捷鍵定義的字元組合。我們已指定按Ctrl+ Q的人物。因此，如果我們按CTRL + Q，我們關閉應用程式。我們把一個製表符之間的＆字元和快捷。這樣，我們就設法把它們之間的一些空間。提供了一個選單項的圖示，我們稱之為SetBitmap（）方法。手動建立的選單項追加到選單呼叫AppendItem（）方法。

self.Bind(wx.EVT_MENU, self.OnQuit, id=APP_EXIT)

當我們選擇建立選單項,OnQuit()方法將被呼叫。

Submenus and separators子選單和分隔符

 Each menu can also have a submenu. This way we can place similar commands into groups. For example we can place commands that hide/show various toolbars like personal bar, address bar, status bar or navigation bar into a submenu called toolbars. Within a menu, we can seperate commands with a separator. It is a simple line. It is common practice to separate commands like New, Open, Save from commands like Print, Pri

每個選單，也可以有一個子選單。這樣我們就可以把成組類似的命令。例如，我們可以將像個人欄，位址列，狀態列或導航欄，將工具欄子選單隱藏/顯示各種工具欄的命令。在選單中，我們可以逗號分開一個分隔的命令。這是一個簡單的線條。常見的做法是單獨的命令，如新建，開啟，儲存，如列印，列印預覽命令與一個單一的分離。在我們的例子中，我們將看到，我們如何能夠建立子選單和選單分隔。

'''
Created on 2012-6-30

@author: Administrator
'''
import wx
class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
    def InitUI(self):
        menuBar = wx.MenuBar()
        
        fileMenu = wx.Menu()
        fileMenu.Append(wx.ID_NEW,"&New")
        fileMenu.Append(wx.ID_OPEN, '&Open')
        fileMenu.Append(wx.ID_SAVE, '&Save')
        fileMenu.AppendSeparator()
        
        imp = wx.Menu()
        imp.Append(wx.ID_ANY, 'Import newsfeed list...')
        imp.Append(wx.ID_ANY, 'Import bookmarks...')
        imp.Append(wx.ID_ANY, 'Import mail...')

        qmi = wx.MenuItem(fileMenu, wx.ID_EXIT, '&Quit\tCtrl+W')
        fileMenu.AppendItem(qmi)
        menuBar.Append(fileMenu, '&File')
        self.SetMenuBar(menuBar)
        
        self.Bind(wx.EVT_MENU, self.OnQuit, qmi)
        
        self.SetSize((400,250))
        self.SetTitle("SimpleMenu")
        #self.Centre()
        self.Center()
        self.Show()
    def OnQuit(self,e):
        self.Close()
    
def main():
    ex = wx.App()
    Example(None)
    ex.MainLoop()
if __name__ == '__main__':
    main()

在上面的示例中,我們建立一個新的,開啟和儲存標準選單項。這些是分開的子選單中有一個水平分隔符。子選單中增加了額外的三個選單項。

fileMenu.Append(wx.ID_NEW, '&New')
fileMenu.Append(wx.ID_OPEN, '&Open')
fileMenu.Append(wx.ID_SAVE, '&Save')

這裡我們有三種常見的選單項。新的、開啟和儲存。

fileMenu.AppendSeparator()

選單分隔符是附有AppendSeparator()方法的。

imp = wx.Menu()
imp.Append(wx.ID_ANY, 'Import newsfeed list...')
imp.Append(wx.ID_ANY, 'Import bookmarks...')
imp.Append(wx.ID_ANY, 'Import mail...')

fileMenu.AppendMenu(wx.ID_ANY, 'I&mport', imp)

也是一個wx.Menu子選單中。三個選單項被追加到選單。子選單附加到檔案選單裡AppenMenu()方法。

Check menu item複選選單


There are tree kinds of menu items. 它們有三種
normal item
check item
radio item


 In the following example, we will demonstrate the check menu item. A check menu item is visually represented by a tick in the menu.

在接下來的例子中,我們將演示如何檢查選單項。一個檢查選單項是視覺上表示為一個滴答在選單。

'''
Created on 2012-6-30

@author: Administrator
'''
import wx

class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
    def InitUI(self):
        menuBar = wx.MenuBar()
        filemenu = wx.Menu()
        viewmenu = wx.Menu()
        
        self.shst = viewmenu.Append(wx.ID_ANY,"ShowStatubar","ShowStatubar",kind=wx.ITEM_CHECK)
        self.shtl = viewmenu.Append(wx.ID_ANY,"ShowToolBar","ShowToolBar",kind=wx.ITEM_CHECK)
        
        viewmenu.Check(self.shst.GetId(),True)
        viewmenu.Check(self.shtl.GetId(),True)
        
        self.Bind(wx.EVT_MENU, self.ToggleStatuBar, self.shst)
        self.Bind(wx.EVT_MENU, self.ToggleToolBar, self.shtl)
        
        menuBar.Append(filemenu, '&File')
        menuBar.Append(viewmenu, '&View')
        self.SetMenuBar(menuBar)
        
        self.toolbar = self.CreateToolBar()
        self.toolbar.AddLabelTool(1,'',wx.Bitmap("exit.png"))
        self.toolbar.Realize()
        
        self.statusbar = self.CreateStatusBar()
        self.statusbar.SetStatusText('Ready')
        
        
        self.SetSize((350, 250))
        self.SetTitle('Check menu item')
        self.Centre()
        self.Show(True)
        
    def ToggleStatuBar(self,e):
        if self.shst.IsChecked():
            self.statusbar.Show()
        else:
            self.statusbar.Hide()
    def ToggleToolBar(self, e):
        
        if self.shtl.IsChecked():
            self.toolbar.Show()
        else:
            self.toolbar.Hide()      

def main():
    ex = wx.App()
    Example(None)
    ex.MainLoop()
if __name__ == '__main__':
    main()

我們有一個檢視選單,我們有兩個檢查選單項。這兩個選單項將顯示和隱藏一個狀態和工具欄。

self.shst = viewMenu.Append(wx.ID_ANY, 'Show statubar', 
    'Show Statusbar', kind=wx.ITEM_CHECK)
self.shtl = viewMenu.Append(wx.ID_ANY, 'Show toolbar', 
    'Show Toolbar', kind=wx.ITEM_CHECK)

如果我們想要新增一個檢查選單項,我們設定一種wx.ITEM_CHECK引數。預設的引數是wx.ITEM_NORMAL。這個Append()方法返回一個wx.MenuItem。

viewMenu.Check(self.shst.GetId(), True)
viewMenu.Check(self.shtl.GetId(), True)

當應用程式啟動時,兩個狀態和工具欄是可見的。所以我們同時檢查選單項的Check()方法。

def ToggleStatusBar(self, e):
    
    if self.shst.IsChecked():
        self.statusbar.Show()
    else:
        self.statusbar.Hide()

顯示或隱藏狀態，根據檢查選單項的狀態。我們發現的IsChecked（）方法檢查選單項的狀態。用相同的工具欄。

Context menu右鍵選單

 A context menu is a list of commands that appears under some context. For example, in a Firefox web browser, when we right click on a web page, we get a context menu. Here we can reload a page, go back or view page source. If we right click on a toolbar, we get another context menu for managing toolbars. Context menus are sometimes called popup menus.

上下文選單在某些情況下出現的命令的列表。例如，在Firefox網頁瀏覽器，當我們在網頁上右擊，我們得到一個上下文選單。在這裡，我們可以重新載入頁面，回去或檢視頁面的原始碼。如果我們右鍵單擊工具欄上，我們得到另一個管理工具欄的上下文選單。有時也被稱為上下文選單彈出選單。

'''
Created on 2012-6-30

@author: Administrator
'''
import wx
class MyPopupMenu(wx.Menu):
    def __init__(self,parent):
        super(MyPopupMenu,self).__init__()
        self.parent = parent
        
        mmi = wx.MenuItem(self,wx.NewId(),'MiniSize')
        self.AppendItem(mmi)
        self.Bind(wx.EVT_MENU, self.OnMinimize, mmi)
        
        cmi = wx.MenuItem(self,wx.NewId(),'Close')
        self.AppendItem(cmi)
        self.Bind(wx.EVT_MENU, self.OnClose, cmi)
        
    def OnMinimize(self,e):
        self.parent.Iconize()
    def OnClose(self,e):
        self.parent.Close()

class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
        
    def InitUI(self):
        self.Bind(wx.EVT_RIGHT_DOWN, self.OnRightDown)
        
        self.SetSize((250, 200))
        self.SetTitle('Context menu')
        self.Centre()
        self.Show(True)
    def OnRightDown(self,e):
        self.PopupMenu(MyPopupMenu(self),e.GetPosition())
    
def main():
    
    ex = wx.App()
    Example(None)
    ex.MainLoop()    


if __name__ == '__main__':
    main()

在這個例子中，我們建立了一個主視窗的上下文選單。它有兩個專案。一個將最大限度地減少應用程式，其他人會終止它。

class MyPopupMenu(wx.Menu):
    
    def __init__(self, parent):
        super(MyPopupMenu, self).__init__()

我們建立一個wx.Menu類

mmi = wx.MenuItem(self, wx.NewId(), 'Minimize')
self.AppendItem(mmi)
self.Bind(wx.EVT_MENU, self.OnMinimize, mmi)

就建立了一個選單項。附加的上下文選單。一個事件處理程式繫結到這個選單項。

self.Bind(wx.EVT_RIGHT_DOWN, self.OnRightDown)

如果我們右鍵單擊該框架,我們稱之為OnRightDown()方法。

def OnRightDown(self, e):
    self.PopupMenu(MyPopupMenu(self), e.GetPosition())

在OnRightDown()方法,我們稱之為PopupMenu()方法。這種方法顯示上下文選單。第一個引數是顯示選單。第二個引數是位置,根據上下文選單就會出現。上下文選單出現在滑鼠游標的地步。以獲得實際的滑鼠位置,我們稱之為GetPosition()方法提供的事件物件。

Toolbars工具條

 Menus group all commands that we can use in an application. Toolbars provide a quick access to the most frequently used commands. 
選單組的所有命令，我們可以在應用程式中使用。工具欄提供一個快速訪問最常用的命令。

 To create a toolbar, we call the CreateToolBar() method of the frame widget.

 要建立一個工具欄，我們呼叫CreateToolBar（）方法的框架部件。

import wx
class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
    def InitUI(self):
        toolbar = self.CreateToolBar()
        qtool = toolbar.AddLabelTool(wx.ID_ANY,"Quit",wx.Bitmap("exit.png"))
        toolbar.Realize()
        
        self.Bind(wx.EVT_TOOL, self.OnQuit, qtool)
        self.SetSize((500,300))
        self.Centre()
        self.Show(True)
    def OnQuit(self,e):
        self.Close()
def main():
    ex = wx.App()
    Example(None)
    ex.MainLoop()
if __name__ == '__main__':
    main()

在我們的示例中,我們有一個工具欄提供了一個工具。當我們點選它，這個工具將關閉應用程式。

toolbar = self.CreateToolBar()

我們建立了一個工具欄。預設情況下,這個工具條是水平的,沒有邊界和顯示圖示。

qtool = toolbar.AddLabelTool(wx.ID_ANY, 'Quit', wx.Bitmap('texit.png'))

建立一個工具欄工具,我們稱之為AddLabelTool()方法。第二個引數是該工具的標籤,第三個是該工具的圖片。注意,這個標籤是不可見的,因為預設樣式只顯示圖示。

toolbar.Realize()

之後，我們已經把我們的專案到工具欄，呼叫Realize()方法。此方法在Linux上不是必須，但windows上要呼叫。

如果我們想要建立一個以上的工具欄,我們必須採取不同的方式。

import wx
class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
    def InitUI(self):
        vbox = wx.BoxSizer(wx.VERTICAL)
        
        toolbar1 = wx.ToolBar(self)
        toolbar1.AddLabelTool(wx.ID_ANY, '', wx.Bitmap("1.png"))
        toolbar1.AddLabelTool(wx.ID_ANY, '', wx.Bitmap("2.png"))
        toolbar1.AddLabelTool(wx.ID_ANY, '', wx.Bitmap("3.png"))
        toolbar1.Realize()
        
        toolbar2 = wx.ToolBar(self)
        qtool = toolbar2.AddLabelTool(wx.ID_EXIT, '', wx.Bitmap("exit.png"))
        toolbar2.Realize()
        
        vbox.Add(toolbar1,0,wx.EXPAND)
        vbox.Add(toolbar2,0,wx.EXPAND)
        
        self.Bind(wx.EVT_TOOL, self.OnQuit, qtool)
        
        self.SetSizer(vbox)
        
        self.SetSize((500,300))
        self.Centre()
        self.Show(True)
    def OnQuit(self,e):
        self.Close()
def main():
    ex = wx.App()
    Example(None)
    ex.MainLoop()
if __name__ == '__main__':
    main()

在上面的示例中,我們建立兩個水平工具欄

toolbar1 = wx.ToolBar(self)
... 
toolbar2 = wx.ToolBar(self)

我們建立兩個工具欄物件。然後放到一個垂直的盒子。

Enable, disable啟用、禁用

 In the following example, we will show, how we can enable and disable toolbar buttons. We will also see a separator line.

在接下來的例子中,我們將展示,我們如何啟用和禁用的工具欄按鈕。我們還將看到一條分隔線。

'''
Created on 2012-7-1

@author: Administrator
'''
import wx
class Example(wx.Frame):
    def __init__(self,*args,**kw):
        super(Example,self).__init__(*args,**kw)
        self.InitUI()
    def InitUI(self):
        self.count = 5
        
        self.toolbar = self.CreateToolBar()
        tundo = self.toolbar.AddLabelTool(wx.ID_UNDO,'',wx.Bitmap("1.png"))
        tredo = self.toolbar.AddLabelTool(wx.ID_REDO,'',wx.Bitmap("2.png"))
        self.toolbar.EnableTool(wx.ID_REDO,False)
        self.toolbar.AddSeparator()
        
        texit = self.toolbar.AddLabelTool(wx.ID_EXIT,'',wx.Bitmap("exit.png"))
        self.toolbar.Realize()
        
        self.Bind(wx.EVT_TOOL, self.OnQuit,texit)
        self.Bind(wx.EVT_TOOL, self.OnUndo,tundo)
        self.Bind(wx.EVT_TOOL, self.OnTredo,tredo)
        
        self.SetSize((500,300))
        self.Centre()
        self.Show(True)
    def OnQuit(self,e):
        self.Close()
    def OnUndo(self,e):
        if self.count > 1 and self.count <= 5:
            self.count = self.count -1
        if self.count == 1:
            self.toolbar.EnableTool(wx.ID_UNDO,False)
        if self.count == 4:
            self.toolbar.EnableTool(wx.ID_REDO,True)
    def OnTredo(self,e):
        if self.count < 5 and self.count >= 1:
            self.count = self.count + 1
        if self.count == 5:
            self.toolbar.EnableTool(wx.ID_REDO,False)
        if self.count == 2:
            self.toolbar.EnableTool(wx.ID_UNDO,True)
def main():
    ex = wx.App()
    Example(None)
    ex.MainLoop()
if __name__ == '__main__':
    main()

在我們的例子中，我們有三個工具欄按鈕。一個按鈕用於退出應用程式。其他兩個按鈕的撤消和重做按鈕。他們模擬在應用程式中的撤消/重做功能。 （對於一個真實的例子，技巧和竅門）我們有4個變化。撤消和重做按鈕被禁用。

self.toolbar.EnableTool(wx.ID_REDO, False)
self.toolbar.AddSeparator()

在開始的時候，重做按鈕被禁用。我們可以通過它呼叫EnableTool（）方法。我們可以在工具欄上建立邏輯組。我們可以由一個小型垂直線分開的不同群體的按鈕。要做到這一點，我們呼叫AddSeparator（）方法。

def OnUndo(self, e):
    if self.count > 1 and self.count <= 5:
        self.count = self.count - 1

    if self.count == 1:
        self.toolbar.EnableTool(wx.ID_UNDO, False)

    if self.count == 4:
        self.toolbar.EnableTool(wx.ID_REDO, True)

我們模擬的撤消和重做功能。我們有4個變化。如果有什麼留下來撤消，撤消按鈕被禁用。後撤銷的第一個變化，我們啟用重做按鈕。同樣的邏輯適用於OnRedo（）方法。