PyQt5 - 在指示器和复选框之间添加间距

本文将介绍如何在 PyQt5 中的复选框和指示器之间添加间距。

指示器和复选框的默认外观

在 PyQt5 中，复选框的默认外观如下图所示：

可以看到，指示器和复选框之间没有任何间距。

需要添加间距的情况

有时候我们希望在复选框和指示器之间添加一些间距，以使它们在视觉上更容易区分。例如，以下是一个带有间距的复选框的例子：

可以看到，指示器和复选框之间有一些空白区域。

在 PyQt5 中添加间距

在 PyQt5 中，我们可以使用 QProxyStyle 类来自定义样式表。我们可以继承 QProxyStyle 类，并重写 drawControl 方法来自定义复选框的绘制。

以下是一个自定义样式的实现：

from PyQt5.QtWidgets import QStyle, QStyleOptionButton, QStylePainter
from PyQt5.QtCore import QSize

class CustomStyle(QProxyStyle):
    def __init__(self, margin):
        super().__init__()
        self.margin = margin
        
    def drawControl(self, element, option, painter, widget=None):
        if element == QStyle.CE_CheckBox:
            margin = self.margin
            check_box_style_option = QStyleOptionButton()
            check_box_style_option.rect = option.rect
            check_box_style_option.state = option.state
            check_box_style_option.state |= QStyle.State_Enabled
            if option.state & QStyle.State_MouseOver:
                check_box_style_option.state |= QStyle.State_MouseOver
            if option.state & QStyle.State_Sunken:
                check_box_style_option.state |= QStyle.State_Sunken

            check_box_rect = self.subElementRect(QStyle.SE_CheckBoxIndicator, check_box_style_option, widget)
            painter.save()
            painter.translate(option.rect.topLeft())
            painter.drawControl(QStyle.CE_CheckBox, check_box_style_option)

            margin = margin
            indicator_width = check_box_rect.width()
            indicator_height = check_box_rect.height()
            text_rect = self.subElementRect(QStyle.SE_CheckBoxContents, check_box_style_option, widget)
            text_rect.adjust(indicator_width + margin, 0, 0, 0)
            self.drawItemText(painter, text_rect, Qt.AlignLeft | Qt.AlignVCenter, option.palette, option.state & QStyle.State_Enabled, option.text)

            painter.restore()

            return

        return super().drawControl(element, option, painter, widget)

在上面的实现中，我们定义了一个 CustomStyle 类，其中 margin 参数表示指示器和文本之间的间距。我们重写了 drawControl 方法，并指定 QStyle.CE_CheckBox 作为 element 参数。在 QStyle.CE_CheckBox 类型的元素中，我们调整了 check_box_rect 和 text_rect 的位置来添加我们指定的间距。

我们还需要使用 setStyle 方法将自定义样式应用到复选框上。以下是一个完整的例子：

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QWidget, QCheckBox, QVBoxLayout
from custom_style import CustomStyle

class App(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Custom Checkbox Style")
        self.setGeometry(100, 100, 400, 300)

        check_box = QCheckBox("Checkbox With Margin")
        check_box.setStyleSheet("margin: 5px;") # margin between checkbox and its container
        check_box.setChecked(True)

        # apply the custom style
        margin = 10
        custom_style = CustomStyle(margin)
        check_box.setStyle(custom_style)

        vbox = QVBoxLayout()
        vbox.addWidget(check_box)

        self.setLayout(vbox)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = App()
    window.show()
    sys.exit(app.exec_())

在上面的例子中，我们创建了一个 App 类，其中包含一个带有一定间距的复选框。我们将其应用自定义样式，并使用 setStyleSheet 方法添加外部边距。

总结

在本文中，我们介绍了如何在 PyQt5 中为复选框添加间距。要实现这一点，我们使用 QProxyStyle 类并重写 drawControl 方法。我们可以使用这个方法来自定义复选框的绘制，并在指示器和文本之间添加间距。