如何使用事件处理器检测点击QTabWidget标签栏后的空白区域？

需求：在QTabWidget的标签栏空白区域（无标签的红色区域）点击时触发自定义事件，比如点击后新增标签。

方案一：使用事件过滤器（推荐，灵活适配） #

通过给QTabWidget的标签栏安装事件过滤器，监听鼠标点击事件并判断点击位置是否在标签范围内：

from PyQt5.QtWidgets import QApplication, QTabWidget, QWidget, QVBoxLayout
from PyQt5.QtCore import QEvent, QPoint

class CustomTabWidget(QTabWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 给标签栏安装事件过滤器
        self.tabBar().installEventFilter(self)

    def eventFilter(self, obj, event):
        if obj == self.tabBar() and event.type() == QEvent.MouseButtonPress:
            click_pos = event.pos()
            tab_count = self.count()
            clicked_on_tab = False
            # 遍历所有标签，检查点击位置是否在标签矩形内
            for i in range(tab_count):
                if self.tabBar().tabRect(i).contains(click_pos):
                    clicked_on_tab = True
                    break
            # 点击空白区域时执行自定义逻辑
            if not clicked_on_tab:
                self.on_blank_area_clicked()
        return super().eventFilter(obj, event)

    def on_blank_area_clicked(self):
        # 此处替换为你需要触发的事件，示例为新增标签
        new_tab = QWidget()
        self.addTab(new_tab, f"新标签 {self.count() + 1}")
        self.setCurrentIndex(self.count() - 1)

if __name__ == "__main__":
    app = QApplication([])
    window = QWidget()
    layout = QVBoxLayout(window)
    tab_widget = CustomTabWidget()
    # 初始化两个测试标签
    tab_widget.addTab(QWidget(), "标签1")
    tab_widget.addTab(QWidget(), "标签2")
    layout.addWidget(tab_widget)
    window.show()
    app.exec_()

方案二：重写QTabBar的鼠标点击事件 #

自定义QTabBar类，重写mousePressEvent直接判断点击位置：

from PyQt5.QtWidgets import QTabBar, QTabWidget, QWidget, QVBoxLayout, QApplication

class CustomTabBar(QTabBar):
    def mousePressEvent(self, event):
        # tabAt返回-1表示点击位置不在任何标签上
        if self.tabAt(event.pos()) == -1:
            self.parent().on_blank_area_clicked()
        super().mousePressEvent(event)

class CustomTabWidget(QTabWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setTabBar(CustomTabBar(self))

    def on_blank_area_clicked(self):
        new_tab = QWidget()
        self.addTab(new_tab, f"新标签 {self.count() + 1}")
        self.setCurrentIndex(self.count() - 1)

if __name__ == "__main__":
    app = QApplication([])
    window = QWidget()
    layout = QVBoxLayout(window)
    tab_widget = CustomTabWidget()
    tab_widget.addTab(QWidget(), "标签1")
    tab_widget.addTab(QWidget(), "标签2")
    layout.addWidget(tab_widget)
    window.show()
    app.exec_()

注意事项 #

• 不同平台的标签栏样式可能存在差异，测试时需验证点击判断的准确性
• 如果标签栏出现滚动按钮（标签过多时），可额外判断点击位置是否在滚动按钮区域内，避免误触发

内容的提问来源于stack exchange，提问作者TI-84-plus