菜單和工具欄

這個章節，我們會創建狀態欄、菜單和工具欄。菜單是一組位於菜單欄的命令。工具欄是應用的一些常用工具按鈕。狀態欄顯示一些狀態信息，通常在應用的底部。

主窗口

QMainWindow提供了主窗口的功能，使用它能創建一些簡單的狀態欄、工具欄和菜單欄。

主窗口是下面這些窗口的合稱，所以教程在最下方。

狀態欄

狀態欄是用來顯示應用的狀態信息的組件。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a statusbar.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QMainWindow, QApplication


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):               

        self.statusBar().showMessage('Ready')

        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle('Statusbar')    
        self.show()


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

 

狀態欄是由QMainWindow創建的。

self.statusBar().showMessage('Ready')

 

調用QtGui.QMainWindow類的statusBar()方法，創建狀態欄。第一次調用創建一個狀態欄，返回一個狀態欄對象。showMessage()方法在狀態欄上顯示一條信息。

程序預覽： 

菜單欄

菜單欄是非常常用的。是一組命令的集合（Mac OS下狀態欄的顯示不一樣，為了得到最相似的外觀，我們增加了一句menubar.setNativeMenuBar(False))。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a menubar. The
menubar has one menu with an exit action.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: January 2017
"""

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication
from PyQt5.QtGui import QIcon


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):               

        exitAct = QAction(QIcon('exit.png'), '&Exit', self)        
        exitAct.setShortcut('Ctrl+Q')
        exitAct.setStatusTip('Exit application')
        exitAct.triggered.connect(qApp.quit)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(exitAct)

        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('Simple menu')    
        self.show()


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

 

我們創建了只有一個命令的菜單欄，這個命令就是終止應用。同時也創建了一個狀態欄。而且還能使用快捷鍵Ctrl+Q退出應用。

exitAct = QAction(QIcon('exit.png'), '&Exit', self)        
exitAct.setShortcut('Ctrl+Q')
exitAct.setStatusTip('Exit application')

 

QAction是菜單欄、工具欄或者快捷鍵的動作的組合。前面兩行，我們創建了一個圖標、一個exit的標簽和一個快捷鍵組合，都執行了一個動作。第三行，創建了一個狀態欄，當鼠標懸停在菜單欄的時候，能顯示當前狀態。

exitAct.triggered.connect(qApp.quit)

 

當執行這個指定的動作時，就觸發了一個事件。這個事件跟QApplication的quit()行為相關聯，所以這個動作就能終止這個應用。

menubar = self.menuBar()
fileMenu = menubar.addMenu('&File')
fileMenu.addAction(exitAct)

 

menuBar()創建菜單欄。這里創建了一個菜單欄，並在上面添加了一個file菜單，並關聯了點擊退出應用的事件。

程序預覽： 

子菜單

子菜單是嵌套在菜單里面的二級或者三級等的菜單。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a submenu.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, QMenu, QApplication

class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):         

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('File')

        impMenu = QMenu('Import', self)
        impAct = QAction('Import mail', self) 
        impMenu.addAction(impAct)

        newAct = QAction('New', self)        

        fileMenu.addAction(newAct)
        fileMenu.addMenu(impMenu)

        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('Submenu')    
        self.show()


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

 

這個例子里，有兩個子菜單，一個在file菜單下面，一個在file的import下面。

impMenu = QMenu('Import', self)

 

使用QMenu創建一個新菜單。

impAct = QAction('Import mail', self) 
impMenu.addAction(impAct)

 

使用addAction添加一個動作。

程序預覽： 

勾選菜單

下面是一個能勾選菜單的例子

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a checkable menu.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, QApplication

class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):         

        self.statusbar = self.statusBar()
        self.statusbar.showMessage('Ready')

        menubar = self.menuBar()
        viewMenu = menubar.addMenu('View')

        viewStatAct = QAction('View statusbar', self, checkable=True)
        viewStatAct.setStatusTip('View statusbar')
        viewStatAct.setChecked(True)
        viewStatAct.triggered.connect(self.toggleMenu)

        viewMenu.addAction(viewStatAct)

        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('Check menu')    
        self.show()

    def toggleMenu(self, state):

        if state:
            self.statusbar.show()
        else:
            self.statusbar.hide()


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

 

本例創建了一個行為菜單。這個行為／動作能切換狀態欄顯示或者隱藏。

viewStatAct = QAction('View statusbar', self, checkable=True)

 

用checkable選項創建一個能選中的菜單。

viewStatAct.setChecked(True)

 

默認設置為選中狀態。

def toggleMenu(self, state):

    if state:
        self.statusbar.show()
    else:
        self.statusbar.hide()

 

依據選中狀態切換狀態欄的顯示與否。 程序預覽：

右鍵菜單

右鍵菜單也叫彈出框（！？），是在某些場合下顯示的一組命令。例如，Opera瀏覽器里，網頁上的右鍵菜單里會有刷新，返回或者查看頁面源代碼。如果在工具欄上右鍵，會得到一個不同的用來管理工具欄的菜單。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a context menu.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QMainWindow, qApp, QMenu, QApplication

class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):         

        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('Context menu')    
        self.show()


    def contextMenuEvent(self, event):

           cmenu = QMenu(self)

           newAct = cmenu.addAction("New")
           opnAct = cmenu.addAction("Open")
           quitAct = cmenu.addAction("Quit")
           action = cmenu.exec_(self.mapToGlobal(event.pos()))

           if action == quitAct:
               qApp.quit()


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

 

還是使用contextMenuEvent()方法實現這個菜單。

action = cmenu.exec_(self.mapToGlobal(event.pos()))

 

使用exec_()方法顯示菜單。從鼠標右鍵事件對象中獲得當前坐標。mapToGlobal()方法把當前組件的相對坐標轉換為窗口（window）的絕對坐標。

if action == quitAct:
    qApp.quit()

 

如果右鍵菜單里觸發了事件，也就觸發了退出事件，執行關閉菜單行為。

程序預覽：

工具欄

菜單欄包含了所有的命令，工具欄就是常用的命令的集合。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a toolbar.
The toolbar has one action, which
terminates the application, if triggered.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication
from PyQt5.QtGui import QIcon

class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):               

        exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
        exitAct.setShortcut('Ctrl+Q')
        exitAct.triggered.connect(qApp.quit)

        self.toolbar = self.addToolBar('Exit')
        self.toolbar.addAction(exitAct)

        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle('Toolbar')    
        self.show()


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

 

上面的例子中，我們創建了一個工具欄。這個工具欄只有一個退出應用的動作。

exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
exitAct.setShortcut('Ctrl+Q')
exitAct.triggered.connect(qApp.quit)

 

和上面的菜單欄差不多，這里使用了一個行為對象，這個對象綁定了一個標簽，一個圖標和一個快捷鍵。這些行為被觸發的時候，會調用QtGui.QMainWindow的quit方法退出應用。

self.toolbar = self.addToolBar('Exit')
self.toolbar.addAction(exitAct)

 

把工具欄展示出來。

程序預覽：

主窗口

主窗口就是上面三種欄目的總稱，現在我們把上面的三種欄在一個應用里展示出來。

首先要自己弄個小圖標，命名為exit24.png

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a skeleton of
a classic GUI application with a menubar,
toolbar, statusbar, and a central widget. 

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QMainWindow, QTextEdit, QAction, QApplication
from PyQt5.QtGui import QIcon


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):               

        textEdit = QTextEdit()
        self.setCentralWidget(textEdit)

        exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
        exitAct.setShortcut('Ctrl+Q')
        exitAct.setStatusTip('Exit application')
        exitAct.triggered.connect(self.close)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(exitAct)

        toolbar = self.addToolBar('Exit')
        toolbar.addAction(exitAct)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Main window')    
        self.show()


if __name__ == '__main__':

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

 

上面的代碼創建了一個很經典的菜單框架，有右鍵菜單，工具欄和狀態欄。

textEdit = QTextEdit()
self.setCentralWidget(textEdit)

 

這里創建了一個文本編輯區域，並把它放在QMainWindow的中間區域。這個組件或占滿所有剩余的區域。

程序預覽：