• 菜单和工具栏
    • 主窗口
    • 状态栏
    • 菜单栏
    • 子菜单
    • 勾选菜单
    • 右键菜单
    • 工具栏
    • 主窗口

    菜单和工具栏

    这个章节,我们会创建状态栏、菜单和工具栏。菜单是一组位于菜单栏的命令。工具栏是应用的一些常用工具按钮。状态栏显示一些状态信息,通常在应用的底部。

    主窗口

    QMainWindow提供了主窗口的功能,使用它能创建一些简单的状态栏、工具栏和菜单栏。

    主窗口是下面这些窗口的合称,所以教程在最下方。

    状态栏

    状态栏是用来显示应用的状态信息的组件。

    1. #!/usr/bin/python3
    2. # -*- coding: utf-8 -*-
    3. """
    4. ZetCode PyQt5 tutorial
    5. This program creates a statusbar.
    6. Author: Jan Bodnar
    7. Website: zetcode.com
    8. Last edited: August 2017
    9. """
    10. import sys
    11. from PyQt5.QtWidgets import QMainWindow, QApplication
    12. class Example(QMainWindow):
    13. def __init__(self):
    14. super().__init__()
    15. self.initUI()
    16. def initUI(self):
    17. self.statusBar().showMessage('Ready')
    18. self.setGeometry(300, 300, 250, 150)
    19. self.setWindowTitle('Statusbar')
    20. self.show()
    21. if __name__ == '__main__':
    22. app = QApplication(sys.argv)
    23. ex = Example()
    24. sys.exit(app.exec_())

    状态栏是由QMainWindow创建的。

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

    调用QtGui.QMainWindow类的statusBar()方法,创建状态栏。第一次调用创建一个状态栏,返回一个状态栏对象。showMessage()方法在状态栏上显示一条信息。

    程序预览:
    status

    菜单栏

    菜单栏是非常常用的。是一组命令的集合(Mac OS下状态栏的显示不一样,为了得到最相似的外观,我们增加了一句menubar.setNativeMenuBar(False))。

    1. #!/usr/bin/python3
    2. # -*- coding: utf-8 -*-
    3. """
    4. ZetCode PyQt5 tutorial
    5. This program creates a menubar. The
    6. menubar has one menu with an exit action.
    7. Author: Jan Bodnar
    8. Website: zetcode.com
    9. Last edited: January 2017
    10. """
    11. import sys
    12. from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication
    13. from PyQt5.QtGui import QIcon
    14. class Example(QMainWindow):
    15. def __init__(self):
    16. super().__init__()
    17. self.initUI()
    18. def initUI(self):
    19. exitAct = QAction(QIcon('exit.png'), '&Exit', self)
    20. exitAct.setShortcut('Ctrl+Q')
    21. exitAct.setStatusTip('Exit application')
    22. exitAct.triggered.connect(qApp.quit)
    23. self.statusBar()
    24. menubar = self.menuBar()
    25. fileMenu = menubar.addMenu('&File')
    26. fileMenu.addAction(exitAct)
    27. self.setGeometry(300, 300, 300, 200)
    28. self.setWindowTitle('Simple menu')
    29. self.show()
    30. if __name__ == '__main__':
    31. app = QApplication(sys.argv)
    32. ex = Example()
    33. sys.exit(app.exec_())

    我们创建了只有一个命令的菜单栏,这个命令就是终止应用。同时也创建了一个状态栏。而且还能使用快捷键Ctrl+Q退出应用。

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

    QAction是菜单栏、工具栏或者快捷键的动作的组合。前面两行,我们创建了一个图标、一个exit的标签和一个快捷键组合,都执行了一个动作。第三行,创建了一个状态栏,当鼠标悬停在菜单栏的时候,能显示当前状态。

    1. exitAct.triggered.connect(qApp.quit)

    当执行这个指定的动作时,就触发了一个事件。这个事件跟QApplication的quit()行为相关联,所以这个动作就能终止这个应用。

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

    menuBar()创建菜单栏。这里创建了一个菜单栏,并在上面添加了一个file菜单,并关联了点击退出应用的事件。

    程序预览:
    menu

    子菜单

    子菜单是嵌套在菜单里面的二级或者三级等的菜单。

    1. #!/usr/bin/python3
    2. # -*- coding: utf-8 -*-
    3. """
    4. ZetCode PyQt5 tutorial
    5. This program creates a submenu.
    6. Author: Jan Bodnar
    7. Website: zetcode.com
    8. Last edited: August 2017
    9. """
    10. import sys
    11. from PyQt5.QtWidgets import QMainWindow, QAction, QMenu, QApplication
    12. class Example(QMainWindow):
    13. def __init__(self):
    14. super().__init__()
    15. self.initUI()
    16. def initUI(self):
    17. menubar = self.menuBar()
    18. fileMenu = menubar.addMenu('File')
    19. impMenu = QMenu('Import', self)
    20. impAct = QAction('Import mail', self)
    21. impMenu.addAction(impAct)
    22. newAct = QAction('New', self)
    23. fileMenu.addAction(newAct)
    24. fileMenu.addMenu(impMenu)
    25. self.setGeometry(300, 300, 300, 200)
    26. self.setWindowTitle('Submenu')
    27. self.show()
    28. if __name__ == '__main__':
    29. app = QApplication(sys.argv)
    30. ex = Example()
    31. sys.exit(app.exec_())

    这个例子里,有两个子菜单,一个在file菜单下面,一个在file的import下面。

    1. impMenu = QMenu('Import', self)

    使用QMenu创建一个新菜单。

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

    使用addAction添加一个动作。

    程序预览:
    submenu

    勾选菜单

    下面是一个能勾选菜单的例子

    1. #!/usr/bin/python3
    2. # -*- coding: utf-8 -*-
    3. """
    4. ZetCode PyQt5 tutorial
    5. This program creates a checkable menu.
    6. Author: Jan Bodnar
    7. Website: zetcode.com
    8. Last edited: August 2017
    9. """
    10. import sys
    11. from PyQt5.QtWidgets import QMainWindow, QAction, QApplication
    12. class Example(QMainWindow):
    13. def __init__(self):
    14. super().__init__()
    15. self.initUI()
    16. def initUI(self):
    17. self.statusbar = self.statusBar()
    18. self.statusbar.showMessage('Ready')
    19. menubar = self.menuBar()
    20. viewMenu = menubar.addMenu('View')
    21. viewStatAct = QAction('View statusbar', self, checkable=True)
    22. viewStatAct.setStatusTip('View statusbar')
    23. viewStatAct.setChecked(True)
    24. viewStatAct.triggered.connect(self.toggleMenu)
    25. viewMenu.addAction(viewStatAct)
    26. self.setGeometry(300, 300, 300, 200)
    27. self.setWindowTitle('Check menu')
    28. self.show()
    29. def toggleMenu(self, state):
    30. if state:
    31. self.statusbar.show()
    32. else:
    33. self.statusbar.hide()
    34. if __name__ == '__main__':
    35. app = QApplication(sys.argv)
    36. ex = Example()
    37. sys.exit(app.exec_())

    本例创建了一个行为菜单。这个行为/动作能切换状态栏显示或者隐藏。

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

    checkable选项创建一个能选中的菜单。

    1. viewStatAct.setChecked(True)

    默认设置为选中状态。

    1. def toggleMenu(self, state):
    2. if state:
    3. self.statusbar.show()
    4. else:
    5. self.statusbar.hide()

    依据选中状态切换状态栏的显示与否。
    程序预览:

    checkmenu

    右键菜单

    右键菜单也叫弹出框(!?),是在某些场合下显示的一组命令。例如,Opera浏览器里,网页上的右键菜单里会有刷新,返回或者查看页面源代码。如果在工具栏上右键,会得到一个不同的用来管理工具栏的菜单。

    1. #!/usr/bin/python3
    2. # -*- coding: utf-8 -*-
    3. """
    4. ZetCode PyQt5 tutorial
    5. This program creates a context menu.
    6. Author: Jan Bodnar
    7. Website: zetcode.com
    8. Last edited: August 2017
    9. """
    10. import sys
    11. from PyQt5.QtWidgets import QMainWindow, qApp, QMenu, QApplication
    12. class Example(QMainWindow):
    13. def __init__(self):
    14. super().__init__()
    15. self.initUI()
    16. def initUI(self):
    17. self.setGeometry(300, 300, 300, 200)
    18. self.setWindowTitle('Context menu')
    19. self.show()
    20. def contextMenuEvent(self, event):
    21. cmenu = QMenu(self)
    22. newAct = cmenu.addAction("New")
    23. opnAct = cmenu.addAction("Open")
    24. quitAct = cmenu.addAction("Quit")
    25. action = cmenu.exec_(self.mapToGlobal(event.pos()))
    26. if action == quitAct:
    27. qApp.quit()
    28. if __name__ == '__main__':
    29. app = QApplication(sys.argv)
    30. ex = Example()
    31. sys.exit(app.exec_())

    还是使用contextMenuEvent()方法实现这个菜单。

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

    使用exec_()方法显示菜单。从鼠标右键事件对象中获得当前坐标。mapToGlobal()方法把当前组件的相对坐标转换为窗口(window)的绝对坐标。

    1. if action == quitAct:
    2. qApp.quit()

    如果右键菜单里触发了事件,也就触发了推出事件,我们就关闭菜单。

    程序预览:

    contextmenu

    工具栏

    菜单栏包含了所有的命令,工具栏就是常用的命令的集合。

    1. #!/usr/bin/python3
    2. # -*- coding: utf-8 -*-
    3. """
    4. ZetCode PyQt5 tutorial
    5. This program creates a toolbar.
    6. The toolbar has one action, which
    7. terminates the application, if triggered.
    8. Author: Jan Bodnar
    9. Website: zetcode.com
    10. Last edited: August 2017
    11. """
    12. import sys
    13. from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication
    14. from PyQt5.QtGui import QIcon
    15. class Example(QMainWindow):
    16. def __init__(self):
    17. super().__init__()
    18. self.initUI()
    19. def initUI(self):
    20. exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
    21. exitAct.setShortcut('Ctrl+Q')
    22. exitAct.triggered.connect(qApp.quit)
    23. self.toolbar = self.addToolBar('Exit')
    24. self.toolbar.addAction(exitAct)
    25. self.setGeometry(300, 300, 300, 200)
    26. self.setWindowTitle('Toolbar')
    27. self.show()
    28. if __name__ == '__main__':
    29. app = QApplication(sys.argv)
    30. ex = Example()
    31. sys.exit(app.exec_())

    上面的例子中,我们创建了一个工具栏。这个工具栏只有一个退出应用的动作。

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

    和上面的菜单栏差不多,这里使用了一个行为对象,这个对象绑定了一个标签,一个图标和一个快捷键。这些行为被触发的时候,会调用QtGui.QMainWindow的quit方法退出应用。

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

    把工具栏展示出来。

    程序预览:

    toolbar

    主窗口

    主窗口就是上面三种栏目的总称,现在我们把上面的三种栏在一个应用里展示出来。

    首先要自己弄个小图标,命名为exit24.png

    1. #!/usr/bin/python3
    2. # -*- coding: utf-8 -*-
    3. """
    4. ZetCode PyQt5 tutorial
    5. This program creates a skeleton of
    6. a classic GUI application with a menubar,
    7. toolbar, statusbar, and a central widget.
    8. Author: Jan Bodnar
    9. Website: zetcode.com
    10. Last edited: August 2017
    11. """
    12. import sys
    13. from PyQt5.QtWidgets import QMainWindow, QTextEdit, QAction, QApplication
    14. from PyQt5.QtGui import QIcon
    15. class Example(QMainWindow):
    16. def __init__(self):
    17. super().__init__()
    18. self.initUI()
    19. def initUI(self):
    20. textEdit = QTextEdit()
    21. self.setCentralWidget(textEdit)
    22. exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
    23. exitAct.setShortcut('Ctrl+Q')
    24. exitAct.setStatusTip('Exit application')
    25. exitAct.triggered.connect(self.close)
    26. self.statusBar()
    27. menubar = self.menuBar()
    28. fileMenu = menubar.addMenu('&File')
    29. fileMenu.addAction(exitAct)
    30. toolbar = self.addToolBar('Exit')
    31. toolbar.addAction(exitAct)
    32. self.setGeometry(300, 300, 350, 250)
    33. self.setWindowTitle('Main window')
    34. self.show()
    35. if __name__ == '__main__':
    36. app = QApplication(sys.argv)
    37. ex = Example()
    38. sys.exit(app.exec_())

    上面的代码创建了一个很经典的菜单框架,有右键菜单,工具栏和状态栏。

    1. textEdit = QTextEdit()
    2. self.setCentralWidget(textEdit)

    这里创建了一个文本编辑区域,并把它放在QMainWindow的中间区域。这个组件或占满所有剩余的区域。

    程序预览:

    mainwindow