25.PyQt5【高级组件】选项卡-QTabWidget
一、前言
如果表单有太多需要同时显示的字段,可以将它们排列在不同的页面中,放置在选项卡式小部件的每个选项卡下。提供了一个标签栏和一个页面区域。显示第一个选项卡下的页面,隐藏其他页面。用户可以通过单击所需的选项卡来查看任何页面。
二、学习目标
1.QTabWidget常用方法
2.QTabWidget常用信号
3.QTabWidget组件的应用
三、知识点
1.【QTabWidget常用方法】
方法 | 描述 |
---|---|
addTab(widget,text) | 将一个控件添加到Tab控件的选项卡中 |
insertTab(index,widget,icon,label) | 将一个Tab控件的选项卡插入到指定的位置 |
removeTab(index) | 根据指定的索引删除Tab控件 |
setCurrentIndex(index) | 设置当前可见的选项卡所在的索引 |
setCurrentWidget(widget) | 设置当前可见的界面 |
setTabText(index,text) | 设置指定索引的选项卡的文本值。如果提供的文本包含“&”字符(“?”),则会自动为其创建快捷方式。 |
setTabEnabled(index,enabled) | 设置指定索引的选项卡是否可用 |
setTabIcon(index,icon) | 设置指定索引的选项卡的图标 |
setTabVisible(index,visible) | 设置指定索引的选项卡是否可见。如果visible为true则可见;否则为false。 |
setTabsClosable(closeable) | 设置是否将关闭按钮自动添加到每个选项卡 |
setTabPosition(position) | 选项卡的位置由值控制 QTabWidget.North:页面上方的 QTabWidget.South:页面下方的 QTabWidget.West:页面左侧的 QTabWidget.East:页面右侧的 |
tabText(index) | 返回页面上位置index处的选项卡的标签文本 |
widget(index) | 返回位于索引位置index的选项卡页;如果索引超出范围,则返回None |
indexOf(widget) | 返回指定选项卡组件的索引值 |
currentIndex() | 返回当前显示的选项卡的索引值 |
currentWidget() | 返回当前显示的选项卡的组件 |
count() | 返回选项卡的数量 |
isTabEnabled(index) | 如果启用了位置索引页面,则返回true;否则,返回true。否则返回false |
isTabVisible(index) | 如果位置索引处的页面可见,则返回true;否则返回true。否则返回false |
clear() | 清除所有页面 |
2.【QTabWidget常用信号】
信号 | 描述 |
---|---|
currentChanged(index) | 每当当前页面索引发生变化时,触发信号 |
tabBarClicked(index) | 单击选项卡栏时,触发信号 |
tabBarDoubleClicked(index) | 双击选项卡栏时,触发信号 |
tabCloseRequested(index) | 单击选项卡上的关闭按钮时,触发信号 |
3.【QTabWidget组件的应用】
import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QTabWidget, QFormLayout, QLineEdit
class QmyWidget(QWidget):
def __init__(self, parent=None):
super().__init__(parent) # 调用父类的构造函数,创建QWidget窗体
self.setupUi()
def setupUi(self):
"""页面初始化"""
# 设置窗体大小及标题
self.resize(500, 400)
self.setWindowTitle("QTabWidget组件示例")
# 创建布局
self.main_layout = QVBoxLayout()
# QTabWidget组件定义
self.tabWidget = QTabWidget() # 定义选项卡组件
self.tab1 = QWidget() # 定义tab页1
self.setupTab1() # 初始化新构造的tab1
self.tab2 = QWidget() # 定义tab页2
self.tab3 = QWidget() # 定义tab页3
# QTabWidget组件设置
self.tabWidget.addTab(self.tab1, "Tab 1") # 将tab1添加到选项卡组件
self.tabWidget.addTab(self.tab2, "Tab 2") # 将tab2添加到选项卡组件
self.tabWidget.addTab(self.tab3, "Tab 3") # 将tab3添加到选项卡组件
self.tabWidget.setTabsClosable(True) # 给每个选项卡设置关闭按钮
self.tabWidget.setTabPosition(QTabWidget.East) # 设置选项卡的位置
self.tabWidget.setCurrentIndex(1) # 设置当前默认显示的tab页
# QTabWidget绑定信号
self.tabWidget.currentChanged.connect(self.on_tabWidget_currentChanged)
# 将组件添加到布局中
self.main_layout.addWidget(self.tabWidget)
# 为窗体添加布局
self.setLayout(self.main_layout)
def setupTab1(self):
"""tab1页面初始化"""
self.layout = QFormLayout()
# 2.设置表单格式
self.layout.setLabelAlignment(Qt.AlignLeft)
self.layout.setFormAlignment(Qt.AlignRight)
# 3.创建输入组件
name_edit = QLineEdit()
mail_edit = QLineEdit()
# 4.为表单添加行
self.layout.addRow("Name:", name_edit)
self.layout.addRow("Mail:", mail_edit)
# 5.为窗体设置表单布局
self.tab1.setLayout(self.layout)
def on_tabWidget_currentChanged(self, index):
"""选项卡切换槽函数"""
print("选项卡当前切换为:{}".format(str(index)))
if __name__ == '__main__':
app = QApplication(sys.argv)
myMain = QmyWidget()
myMain.show()
sys.exit(app.exec_())