强制 QTabBar 选项卡保持尽可能小并忽略 sizeHint

Posted 2023-03-30

【中文标题】强制 QTabBar 选项卡保持尽可能小并忽略 sizeHint

【英文标题】：Force QTabBar tabs to stay as small as possible and ignore sizeHint

【发布时间】：2020-08-04 16:40:50

【问题描述】：

我正在尝试将+ 按钮添加到QTabBar。几年前有一个great solution，有一个小问题是它不适用于PySide2。问题是由选项卡自动调整大小以填充sizeHint 引起的，在这种情况下不需要额外的空间，因为需要额外的空间。有没有办法可以禁用此行为？

我试过QTabBar.setExpanding(False)，但是根据this的回答，该属性大多被忽略了：

坏消息是 QTabWidget 实际上忽略了该属性，因为它总是强制其选项卡为最小尺寸（即使您设置了自己的选项卡栏）。

区别在于PySide2，它强制选项卡成为首选大小，我想要最小大小的旧行为。

编辑： 代码最少的示例。 sizeHint 宽度将选项卡拉伸到整个宽度，而在旧 Qt 版本中它不会这样做。我无法真正覆盖tabSizeHint，因为我不知道原始标签大小应该是多少。

import sys
from PySide2 import QtCore, QtWidgets

class TabBar(QtWidgets.QTabBar):
    def sizeHint(self):
        return QtCore.QSize(100000, super().sizeHint().height())

class Test(QtWidgets.QDialog):
    def __init__(self, parent=None):
        super(Test, self).__init__(parent)

        layout = QtWidgets.QVBoxLayout()
        self.setLayout(layout)

        tabWidget = QtWidgets.QTabWidget()
        tabWidget.setTabBar(TabBar())
        layout.addWidget(tabWidget)

        tabWidget.addTab(QtWidgets.QWidget(), 'this shouldnt be stretched')

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    test = Test()
    test.show()
    sys.exit(app.exec_())

【问题讨论】：

可以举一个简单的例子吗？我熟悉pyqt5，但不一定是pyside。

嘿，刚刚做了快速示例

感谢您的示例。它确实使快速提出解决方案变得容易得多。我什至发现自己有时会在找出重现问题的确切最小代码量时回答自己的问题。事实证明，pyside 和 pyqt 在很大程度上是兼容的。

我使用Qt.py 来处理PySide、PyQt4、PySide2 和PyQt5 之间的任何兼容性问题，当我们仍然必须使用 Python 2 处理大多数事情时，这是工作中的完整救生员:)

我稍后再看一下。由于我的回答不对，我先删了。

【参考方案1】：

我认为您的问题可能有一个简单的解决方案（见下文）。在链接的部分解决方案计算“+”按钮的绝对定位的情况下，Qt 的真正意图始终是让布局引擎完成它，而不是试图告诉它特定的大小和位置。 QTabWidget 基本上是布局和小部件的预构建合并，有时您只需跳过预构建并构建自己的。

使用跨 TabBar 的额外内容构建自定义 TabWidget 的示例：

import sys
from PySide2 import QtWidgets
from random import randint
    
class TabWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        #layout for entire widget
        vbox = QtWidgets.QVBoxLayout(self)
        
        #top bar:
        hbox = QtWidgets.QHBoxLayout()
        vbox.addLayout(hbox)
        
        self.tab_bar = QtWidgets.QTabBar()
        self.tab_bar.setMovable(True)
        hbox.addWidget(self.tab_bar)
        
        spacer = QtWidgets.QSpacerItem(0,0,QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Fixed)
        hbox.addSpacerItem(spacer)
        
        add_tab = QtWidgets.QPushButton('+')
        hbox.addWidget(add_tab)
        
        #tab content area:
        self.widget_stack = QtWidgets.QStackedLayout()
        vbox.addLayout(self.widget_stack)
        self.widgets = 

        #connect events
        add_tab.clicked.connect(self.add_tab)
        self.tab_bar.currentChanged.connect(self.currentChanged)
        
    def add_tab(self):
        tab_text = 'tab' + str(randint(0,100))
        tab_index = self.tab_bar.addTab(tab_text)
        widget = QtWidgets.QLabel(tab_text)
        self.tab_bar.setTabData(tab_index, widget)
        
        self.widget_stack.addWidget(widget)
        
        self.tab_bar.setCurrentIndex(tab_index)

        
    def currentChanged(self, i):
        if i >= 0:
            self.widget_stack.setCurrentWidget(self.tab_bar.tabData(i))
        


if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    test = TabWidget()
    test.show()
    sys.exit(app.exec_())

话虽如此，我认为预建的QTabWidget.setCornerWidget 可能正是您正在寻找的（将 QPushButton 设置为右上角的小部件）。我编写的示例应该更容易定制，但也需要付出更多努力来重新实现所有相同的功能。您将不得不重新实现一些信号逻辑来自行创建/删除/选择/重新排列选项卡。我只演示了简单的实现，它可能并非在所有情况下都万无一失。

【讨论】：

干杯，+ 按钮需要尺寸提示才能适应，所以我无法删除它，我只将其设置为高数字来演示问题。然而，设置对齐并没有停止拉伸 - i.imgur.com/ZBHxuZX.png（作为参考，这是它在 PySide - i.imgur.com/wrGuHej.png 中的样子）

@Peter 经过一些额外的研究，我完全重写了我的答案。我认为手动提示 TabBar 的大小以使绝对定位的按钮适合正确的空间的方法不是一个可持续的解决方案。看起来 QTabWidget 已经能够将自定义按钮（或任何小部件）添加到角落，我还构建了一个编写您自己版本的 TabWidget 的示例以获得更大的灵活性。

谢谢，这看起来确实更健壮，如果看起来不那么漂亮。我不得不做一些小改动——将分隔符移到+ 按钮之后，覆盖标签栏的minimumSizeHint 以始终返回0 的宽度，在空白时隐藏标签栏。在选择这个答案之前，我将努力为我现有的工具实现它，只是为了检查它是否正确支持

我在重新实现功能时注意到的另一个小问题 - 使用 tabBar.tabAt(point) 就像布局上没有 contentsMargins 一样，因此需要考虑或删除这些问题

感谢您的所有帮助，如果它对其他人有用，请添加我的最终代码作为答案

【参考方案2】：

以 Aaron 的代码为基础，我设法实现了使用现有脚本所需的所有功能：

from PySide2 import QtCore, QtWidgets

class TabBar(QtWidgets.QTabBar):
    def minimumSizeHint(self):
        """Allow the tab bar to shrink as much as needed."""
        minimumSizeHint = super(TabBar, self).minimumSizeHint()
        return QtCore.QSize(0, minimumSizeHint.height())

class TabWidgetPlus(QtWidgets.QWidget):

    tabOpenRequested = QtCore.Signal()
    tabCountChanged = QtCore.Signal(int)

    def __init__(self, parent=None):
        self._addingTab = False
        super(TabWidgetPlus, self).__init__(parent=parent)

        # Main layout
        layout = QtWidgets.QVBoxLayout(self)
        layout.setContentsMargins(0, 0, 0, 0)

        # Bar layout
        self._tabBarLayout = QtWidgets.QHBoxLayout()
        self._tabBarLayout.setContentsMargins(0, 0, 0, 0)
        self._tabBarLayout.setSpacing(0)
        layout.addLayout(self._tabBarLayout)

        self._tabBar = TabBar()
        self._tabBarLayout.addWidget(self._tabBar)
        for method in (
                'isMovable', 'setMovable',
                'tabsClosable', 'setTabsClosable',
                'tabIcon', 'setTabIcon',
                'tabText', 'setTabText',
                'currentIndex', 'setCurrentIndex',
                'currentChanged', 'tabCloseRequested',
            ):
            setattr(self, method, getattr(self._tabBar, method))

        self._plusButton = QtWidgets.QPushButton('+')
        self._tabBarLayout.addWidget(self._plusButton)  # TODO: Find location to insert
        self._plusButton.setFixedWidth(20)

        self._tabBarLayout.addStretch()

        # Content area
        self._contentArea = QtWidgets.QStackedLayout()
        layout.addLayout(self._contentArea)

        # Signals
        self.currentChanged.connect(self._currentChanged)
        self._plusButton.clicked.connect(self.tabOpenRequested.emit)

        # Final setup
        self.installEventFilter(self)

    @QtCore.Slot(int)
    def _currentChanged(self, i):
        """Update the widget."""
        if i >= 0 and not self._addingTab:
            self._contentArea.setCurrentWidget(self.tabBar().tabData(i))

    def eventFilter(self, obj, event):
        """Intercept events until the correct height is set."""
        if event.type() == QtCore.QEvent.Show:
            self.plusButton().setFixedHeight(self._tabBar.geometry().height())
            self.removeEventFilter(self)
        return False

    def tabBarLayout(self):
        return self._tabBarLayout

    def tabBar(self):
        return self._tabBar

    def plusButton(self):
        return self._plusButton

    def tabAt(self, point):
        """Get the tab at a given point.
        This takes any layout margins into account.
        """
        offset = self.layout().contentsMargins().top() + self.tabBarLayout().contentsMargins().top()
        return self.tabBar().tabAt(point - QtCore.QPoint(0, offset))

    def addTab(self, widget, name=''):
        """Add a new tab.

        Returns:
            Tab index as an int.
        """
        self._addingTab = True
        tabBar = self.tabBar()
        try:
            index = tabBar.addTab(name)
            tabBar.setTabData(index, widget)
            self._contentArea.addWidget(widget)

        finally:
            self._addingTab = False
        return index

    def insertTab(self, index, widget, name=''):
        """Inserts a new tab.
        If index is out of range, a new tab is appended.

        Returns:
            Tab index as an int.
        """
        self._addingTab = True
        tabBar = self.tabBar()
        try:
            index = tabBar.insertTab(index, name)
            tabBar.setTabData(index, widget)
            self._contentArea.insertWidget(index, widget)

        finally:
            self._addingTab = False
        return index

    def removeTab(self, index):
        """Remove a tab."""
        tabBar = self.tabBar()
        self._contentArea.removeWidget(tabBar.tabData(index))
        tabBar.removeTab(index)


if __name__ == '__main__':
    import sys
    import random

    app = QtWidgets.QApplication(sys.argv)
    test = TabWidgetPlus()

    test.addTab(QtWidgets.QPushButton(), 'yeah')
    test.insertTab(0, QtWidgets.QCheckBox(), 'what')
    test.insertTab(1, QtWidgets.QRadioButton(), 'no')
    test.removeTab(1)
    test.setMovable(True)
    test.setTabsClosable(True)

    def tabTest():
        name = 'Tab ' + str(random.randint(0, 100))
        index = test.addTab(QtWidgets.QLabel(name), name)
        test.setCurrentIndex(index)
    test.tabOpenRequested.connect(tabTest)
    test.tabCloseRequested.connect(lambda index: test.removeTab(index))

    test.show()
    sys.exit(app.exec_())

一个区别是如果您使用tabWidget.tabBar().tabAt(point)，则不再保证正确，因为它不考虑任何边距。我将边距设置为0，所以这应该不是问题，但我还在TabWidgetPlus.tabAt 中包含了这些更正。

我只复制了从QTabBar 到QTabWidget 的一些方法，因为有些方法可能需要额外的测试。