PyQt6/PySide6 的 QtabWidget类

QTabWidget 是 PySide（或 PyQt）库中的一个控件，用于在应用程序中创建和管理多个标签页。每个标签页可以包含不同的内容，用户可以通过点击标签来切换显示不同的内容。QTabWidget 是一个非常常用的组件，尤其是在需要在一个窗口中展示多个不同内容的情况下。

下面我将从多个方面详细介绍 QTabWidget。

---

1. 基本概念

QTabWidget 是一个容器控件，它由以下几个部分组成：

• Tab Bar（标签栏）：显示在顶部或底部的标签，用户可以通过点击标签来切换显示的页面。
• 页面（Page）：每个标签对应一个页面，页面可以包含任意控件。

QTabWidget 提供了灵活的 API，允许开发者自定义标签栏的位置、样式、内容等。

---

2. 创建和使用 QTabWidget

2.1 基本用法

下面是一个简单的示例，展示如何创建一个包含多个标签页的 QTabWidget：

from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QTabWidget, QPushButton

class MyApp(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QTabWidget Example")
        self.setGeometry(100, 100, 400, 300)

        # 创建 QTabWidget
        self.tab_widget = QTabWidget(self)

        # 添加页面
        self.add_tab("Tab 1", "This is the content of Tab 1")
        self.add_tab("Tab 2", "This is the content of Tab 2")
        self.add_tab("Tab 3", "This is the content of Tab 3")

        # 设置布局
        layout = QVBoxLayout()
        layout.addWidget(self.tab_widget)
        self.setLayout(layout)

    def add_tab(self, title, content):
        # 创建一个 QWidget 作为页面
        page = QWidget()
        layout = QVBoxLayout(page)
        layout.addWidget(QPushButton(content, page))
        page.setLayout(layout)

        # 将页面添加到 QTabWidget 中
        self.tab_widget.addTab(page, title)

if __name__ == "__main__":
    app = QApplication([])
    window = MyApp()
    window.show()
    app.exec()

2.2 关键方法

• addTab(widget, label): 向 QTabWidget 中添加一个新标签页。widget 是标签页的内容，label 是标签的显示文本。
• insertTab(index, widget, label): 在指定索引位置插入一个新标签页。
• removeTab(index): 移除指定索引的标签页。
• setCurrentIndex(index): 设置当前显示的标签页。
• currentIndex(): 获取当前显示的标签页的索引。
• setTabText(index, text): 设置指定索引的标签页的标题。
• setTabToolTip(index, tooltip): 设置指定索引的标签页的工具提示。

---

3. 标签栏的位置

QTabWidget 允许开发者自定义标签栏的位置，可以通过 setTabPosition 方法设置。

支持的位置：

• QTabWidget.North: 标签栏在顶部（默认）。
• QTabWidget.South: 标签栏在底部。
• QTabWidget.West: 标签栏在左侧。
• QTabWidget.East: 标签栏在右侧。

示例：

self.tab_widget.setTabPosition(QTabWidget.South)  # 将标签栏设置在底部

---

4. 标签页的关闭按钮

QTabWidget 支持为每个标签页添加关闭按钮，允许用户关闭不需要的标签页。

设置方法：

• setTabsClosable(True): 启用标签页的关闭按钮。
• tabCloseRequested.connect(callback): 连接关闭按钮的信号到回调函数。回调函数会接收到被关闭的标签页的索引。

示例：

def close_tab(index):
    self.tab_widget.removeTab(index)

self.tab_widget.setTabsClosable(True)
self.tab_widget.tabCloseRequested.connect(close_tab)

---

5. 自定义标签页样式

QTabWidget 提供了多个属性，允许开发者自定义标签页的外观。

常用方法：

• setTabTextColor(index, color): 设置标签文本的颜色。
• setTabIcon(index, icon): 设置标签的图标。
• setTabEnabled(index, enabled): 设置标签是否可点击。
• setStyleSheet(css): 使用 CSS 样式表自定义标签页的外观。

示例：

from PySide6.QtGui import QIcon

# 设置标签图标
icon = QIcon("path/to/icon.png")
self.tab_widget.setTabIcon(0, icon)

# 设置标签文本颜色
self.tab_widget.setTabTextColor(0, Qt.red)

# 使用 CSS 自定义样式
self.tab_widget.setStyleSheet("""
    QTabBar::tab {
        background-color: #f0f0f0;
        padding: 10px;
        border: 1px solid #ccc;
    }
    QTabBar::tab:selected {
        background-color: #0078d7;
        color: white;
    }
""")

---

6. 信号

QTabWidget 提供了多个信号，用于响应用户操作。

常用信号：

• currentChanged(index): 当前标签页发生变化时触发，index 是新标签页的索引。
• tabCloseRequested(index): 用户点击关闭按钮时触发，index 是关闭的标签页的索引。

示例：

def on_tab_changed(index):
    print(f"Tab changed to: {index}")

self.tab_widget.currentChanged.connect(on_tab_changed)

---

7. 自定义 QTabBar

QTabWidget 的标签栏是其核心部分，可以通过自定义 QTabBar 来实现更复杂的功能。

示例：

from PySide6.QtWidgets import QTabBar, QStylePainter, QStyleOptionTab

class CustomTabBar(QTabBar):
    def paintEvent(self, event):
        painter = QStylePainter(self)
        option = QStyleOptionTab()

        for index in range(self.count()):
            self.initStyleOption(option, index)
            painter.drawControl(QStyle.CE_TabBarTabShape, option)
            painter.drawText(self.tabRect(index), Qt.AlignCenter, self.tabText(index))

# 使用自定义的 QTabBar
self.tab_widget.setTabBar(CustomTabBar())

---

8. 动态添加和移除标签页

QTabWidget 支持动态添加和移除标签页，这在需要频繁改变标签页内容时非常有用。

示例：

def add_new_tab():
    new_tab = QWidget()
    layout = QVBoxLayout(new_tab)
    layout.addWidget(QPushButton("New Tab Content"))
    new_tab.setLayout(layout)

    self.tab_widget.addTab(new_tab, "New Tab")

def remove_current_tab():
    current_index = self.tab_widget.currentIndex()
    self.tab_widget.removeTab(current_index)

# 添加按钮用于动态添加标签页
add_button = QPushButton("Add Tab")
add_button.clicked.connect(add_new_tab)

# 移除按钮用于动态移除标签页
remove_button = QPushButton("Remove Tab")
remove_button.clicked.connect(remove_current_tab)

---

9. 总结

QTabWidget 是 PySide/PyQt 中一个非常强大的控件，适用于需要在一个窗口中展示多个内容页面的场景。通过灵活的 API，开发者可以轻松地实现以下功能：

• 动态添加和移除标签页。
• 自定义标签栏的位置和样式。
• 为标签页添加关闭按钮。
• 响应用户操作的信号。

掌握 QTabWidget 的使用，可以让开发者更高效地构建多功能的 GUI 应用程序。