参考
《PyQT5快速开发与实战》
pyqt5官网：https://doc.qt.io/qtforpython
如果有许多的控件无法在一个页面中全部显示，可以考虑使用容器，装载更多的控件。
1. QTabWidget
QTabWidget控件提供了一个选项卡和一个页面区域(类似于平时看到的浏览器布局)，默认显示第一个选项卡的页面。通过单击各个选项卡可以查看对应的页面。
QTabWidget常用方法：
表1
| 方法 | 描述 |
|---|---|
| addTab() | 将一个控件添加到Tab控件的选项卡中。 |
| insertTab() | 将一个Tab控件的选项卡插入到指定的位置。 |
| removeTab() | 根据指定的索引删除Tab控件。 |
| setCurrentIndex() | 设置当前可见的选项卡所在的索引。 |
| setCurrentWidget() | 设置当前可见的页面。 |
| setTabBar() | 设置选项卡栏的小控件。 |
| setTabPosition() | 设置选项卡的位置: QTabWidget.North ：显示在页面的上方。 QTabWidget.South : 显示在页面的下方。 QTabWidget.West：显示在页面的左侧。 QTabWidget.Ease：显示在页面的右侧。 |
| setTabText() | 定义Tab选项卡的显示值。 |
QTabWidget的常用信号：
表2
| 信号 | 描述 |
|---|---|
| currentChanged | 切换当前页面时发射信号。 |
示例代码1.
# -*- coding=utf-8 -*-
import sys
from PyQt5.QtWidgets import *
class TabDemo(QTabWidget): # 继承自QTabWidget
def __init__(self, parent=None):
super(TabDemo, self).__init__(parent)
self.resize(320, 240) # 窗口大小：宽320，高240
self.setTabPosition(QTabWidget.West) # 设置选项卡显示在页面的左侧
self.contact_tab = QWidget() # 每个选项卡界面其实都是一个QWidget
self.personal_details_tab = QWidget()
# “contact_tab”是对添加进去的contact_tab的描述
self.addTab(self.contact_tab, "contact_tab") # 添加“联系方式”的QWidget到QTabWidget中，成为选项卡
self.addTab(self.personal_details_tab, "personal_details_tab")
self.contact_tab_ui() # 绘制“联系方式”选项卡界面
self.personal_details_tab_ui() # 绘制“个人信息”选项卡界面
def contact_tab_ui(self):
layout = QFormLayout()
layout.addRow("姓名", QLineEdit())
layout.addRow("地址", QLineEdit())
self.setTabText(0, "联系方式") # 定义选项卡的显示值
self.contact_tab.setLayout(layout)
def personal_details_tab_ui(self):
layout = QFormLayout()
sex = QHBoxLayout()
sex.addWidget(QRadioButton("男"))
sex.addWidget(QRadioButton("女"))
layout.addRow(QLabel("性别"), sex)
layout.addRow("生日", QLineEdit())
self.setTabText(1, "个人详细信息")
self.personal_details_tab.setLayout(layout)
if __name__ == "__main__":
app = QApplication(sys.argv)
window = TabDemo()
window.show()
sys.exit(app.exec_())
运行截图：
图1“联系方式”选项卡
图2“个人信息”选项卡
2. QStackedWidget
QStackedWidget是一个堆栈窗口控件，可以填充一些小控件，但是同一时间只能有一个小控件可以显示。
QStackedWidget使用QStackedLayout布局。
QStackedWidget和QTabWidget类似。
图3 QStackedWidget的继承关系
QStackedWidget的常用方法：
表3
| 方法 | 描述 |
|---|---|
| addWidget() | 添加widget到QStackedWidget中，返回索引位置。 |
| count() | 返回QStackedWidget中widget的个数。 |
| currentIndex() | 返回QStackedWidget中当前显示widget的索引。 |
| currentWidget() | 返回QStackedWidget中当前显示的widget。 |
| indexOf() | 返回指定widget在QStackedWidget中的索引。 |
| insertWidget() | 在QStackedWidget中指定位置插入widget。 |
| removeWidget() | 从QStackedWidget中删除指定widget（并没有实际删除，只是移除，相当于隐藏该widget） |
| widget() | 返回指定索引位置的widget。 |
QStackedWidget的常用槽函数：
表4
| 槽 | 描述 |
|---|---|
| setCurrentIndex() | 设置当前要显示widget的索引。 |
| setCurrentWidget() | 设置当前要显示的widget。 |
QStackedWidget的常用信号：
表5
| 信号 | 描述 |
|---|---|
| currentChanged() | 当前显示widget发生变化。 |
| widgetRemoved() | widget被从QStackedWidget中移除。 |
示例代码2.
# -*-coding:utf-8 -*-
import sys
from PyQt5.QtWidgets import *
class StackedExample(QWidget):
def __init__(self):
super(StackedExample, self).__init__()
self.resize(320, 240)
self.setWindowTitle("StackedWidget例子")
self.left_list = QListWidget()
self.left_list.insertItem(0, '联系方式')
self.left_list.insertItem(1, '个人信息')
self.contact_stack = QWidget()
self.personal_detail_stack = QWidget()
self.contact_stack_ui()
self.personal_detail_stack_ui()
self.stack = QStackedWidget(self)
self.stack.addWidget(self.contact_stack)
self.stack.addWidget(self.personal_detail_stack)
hbox = QHBoxLayout(self)
hbox.addWidget(self.left_list)
hbox.addWidget(self.stack)
self.setLayout(hbox)
self.left_list.currentRowChanged.connect(self.display)
def contact_stack_ui(self):
layout = QFormLayout()
layout.addRow('姓名', QLineEdit())
layout.addRow('地址', QLineEdit())
self.contact_stack.setLayout(layout)
def personal_detail_stack_ui(self):
layout = QFormLayout()
sex = QHBoxLayout()
sex.addWidget(QRadioButton('男'))
sex.addWidget(QRadioButton('女'))
layout.addRow(QLabel('性别'), sex)
self.personal_detail_stack.setLayout(layout)
def display(self, i):
self.stack.setCurrentIndex(i)
if __name__ == "__main__":
app = QApplication(sys.argv)
demo = StackedExample()
demo.show()
sys.exit(app.exec_())
运行结果：
图4.“联系方式”界面
图5.“个人信息”界面
3. QDockWidget
QDockWidget是一个可以停靠在QMainWindow内的窗口控件，他可以保持在浮动状态或者在指定位置作为子窗口附加到主窗口中。
图6.QDockWidget的继承关系
图7. QMainWindow 结构图
QMainWindow类的主窗口对象保留有一个用于停靠窗口的区域，这个区域位于控件的中央周围，即（Dock Windows）。
表6.QDockWidget的常用方法
| 方法 | 描述 |
|---|---|
| setWidget() | 在Dock窗口区域设置QWidget. |
| setFloating() | 设置Dock窗口是否可以浮动，如果设置为True,则表示可以浮动。 |
| setAllowedAreas() | 设置窗口可以停靠的区域： 1.LeftDockWidgetArea，左边停靠区域。 2.RightDockWidgetArea，右边停靠区域。 3.TopDockWidgetArea，顶部停靠区域。 4.BottomDockWidgetArea，底部停靠区域。 5.NoDockWidgetArea，不显示Widget。 |
| setFeatures() | 设置停靠窗口的功能属性： 1.DockWidgetClosable，可关闭。 2.DockWidgetMovable，可移动。 3.DockWidgetFloatable，可漂浮。 4.DockWidgetVerticalTitleBar，在左边显示垂直的标签栏。 5.AllDockWidgetFeatures，具有前3种属性的所有功能。 6.NoDockWidgetFeatures，无法关闭，无法移动，无法漂移。 |
示例代码3
# -*-coding:utf-8 -*-
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class DockExample(QMainWindow): # 顶层窗口是一个QMainWindow对象
def __init__(self, parent=None):
super(DockExample, self).__init__(parent)
self.resize(320, 240)
self.setWindowTitle("DockWidget例子")
layout = QHBoxLayout()
bar = self.menuBar()
file = bar.addMenu('Files')
file.addAction('New')
file.addAction('save')
file.addAction('quit')
self.items = QDockWidget('Dockable', self) # 创建可停靠的窗口
# 在停靠窗口items内添加QListWidget对象。
self.list_widget = QListWidget()
self.list_widget.addItem('item1')
self.list_widget.addItem('item2')
self.list_widget.addItem('item3')
self.items.setWidget(self.list_widget)
self.items.setFloating(False)
self.setCentralWidget(QTextEdit()) # QTextEdit对象是QMainWindow对象的中央小控件
# 将停靠窗口items放置在中央小控件的右侧。
self.addDockWidget(Qt.RightDockWidgetArea, self.items)
self.setLayout(layout)
if __name__ == "__main__":
app = QApplication(sys.argv)
demo = DockExample()
demo.show()
sys.exit(app.exec_())
运行结果：
图8.Dockable窗口可以拖动
4.多文档界面
QTabWidget和QStackedWidget控件允许一次使用其中的一个窗口，不过其它窗口是隐藏的。
如果要同时显示多个窗口，就得创建多个独立的窗口，这需要消耗较多的内存资源。
独立的窗口称为SDI（single document interface,单文档界面）
包含这些SDI的窗口称为MDI（multiple document interface,多文档界面）。
MDI应用程序占用较少的内存资源，相比于同时创建多个窗口，MDI的子窗口都可以放在主窗口容器内。该主窗口容器称为QMdiArea。
QMdiArea控件一般放在QMainWindow对象的中央位置，其子窗口在这个区域内是QMdiSubWindow类的实例，，可以设置任何QWidget作为子窗口对象的内部控件，子窗口在MDI区域进行级联排列布局。
图9.QMdiArea类的继承关系
图10.QMdiSubWindow的继承关系
图11.多文档界面
QMdiArea类和QMdiSubWindow类的常用方法：
更多信息得看官网。
表7
| 方法 | 描述 |
|---|---|
| addSubWindow() | 将一个小控件添加在MDI区域作为一个新的子窗口。 |
| removeSubWindow() | 删除一个子窗口中的小控件。 |
| setActiveSubWindow() | 激活一个子窗口。 |
| cascadeSubWindow() | 安排子窗口在MDI区域级联显示。 |
| tileSubWindows() | 安排子窗口在MDI区域平铺显示。 |
| closeActiveSubWindow() | 关闭活动的窗口。 |
| subWindowList() | 返回MDI区域的子窗口列表。 |
| setWidget() | 设置一个小控件作为QMdiSubWindow实例对象的内部控件。 |
代码示例4：
# -*-coding:utf-8 -*-
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class MainWindow(QMainWindow): # 顶层窗口是一个QMainWindow对象
def __init__(self, parent=None):
super(MainWindow, self).__init__(parent)
self.resize(320, 240)
self.setWindowTitle("多文档界面例子")
self.count = 0 # 记录子窗口的数量
self.mdi = QMdiArea()
self.setCentralWidget(self.mdi)
bar = self.menuBar()
file = bar.addMenu('File')
file.addAction('New')
file.addAction('cascade')
file.addAction('Tiled')
# 单击菜单控件时触发triggered信号，连接到槽函数window_action
file.triggered[QAction].connect(self.window_action)
def window_action(self, action):
print('triggered')
if action.text() == 'New': # 添加一个新的SDI，每个SDI都有标题，主窗口内会增加SDI数量
self.count = self.count + 1
sub = QMdiSubWindow()
sub.setWidget(QTextEdit())
sub.setWindowTitle('sub window' + str(self.count))
self.mdi.addSubWindow(sub)
sub.show()
elif action.text() == 'cascade': # 级联显示子窗口
self.mdi.cascadeSubWindows()
elif action.text() == 'Tiled': # 平铺显示子窗口
self.mdi.tileSubWindows()
if __name__ == "__main__":
app = QApplication(sys.argv)
demo = MainWindow()
demo.show()
sys.exit(app.exec_())
运行结果：
图12.点击New，创建新窗口
图13.子窗口的级联布局
图14.子窗口的平铺布局
5. QScrollBar
前4个窗口控件的共同点：新建一些窗口来装在更多的控件。
QScrollBar：提供水平/垂直的滚动条，扩大当前窗口的有效装载面积，从而装载更多控件。
图15. QScrollBar的继承关系
表8. QScrollBar常用信号
| 信号 | 含义 |
|---|---|
| valueChanged() | 当滑动条的值改变时发射此信号。 |
| sliderMoved() | 当用户拖动滑块时发射此信号。 |
示例代码5：
# -*-coding:utf-8 -*-
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
class ScrollExample(QWidget):
def __init__(self, parent=None):
super(ScrollExample, self).__init__(parent)
self.resize(320, 240)
self.setWindowTitle("滚动条例子")
self.scroll_bar = QScrollBar(self)
self.scroll_bar.resize(20, 240)
self.scroll_bar.valueChanged.connect(self.slider_slot)
self.pushbutton = QPushButton('测试', self)
self.pushbutton.setGeometry(40, 0, 40, 30)
def slider_slot(self, value):
self.pushbutton.move(40, value)
if __name__ == "__main__":
app = QApplication(sys.argv)
demo = ScrollExample()
demo.show()
sys.exit(app.exec_())
运行结果：
图16.拖动滚动条，“测试”按钮一起移动
扫一扫
1101
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
