如何通过QSS样式表设置PyQt自定义属性？

一、利用Q_PROPERTY暴露属性让QSS可控 #

Qt的QSS支持通过qproperty-<属性名>语法设置经Q_PROPERTY注册的类属性。你可以修改Line类，将thickness和direction注册为可被QSS控制的属性，同时在属性变化时自动调整控件的尺寸策略与固定大小。

修改后的代码示例：

from PyQt5.QtCore import Qt, pyqtProperty
from PyQt5.QtWidgets import QWidget, QSizePolicy
from typing import Optional

class Line(QWidget):
    def __init__(self, direction: Qt.Orientation, thickness: int, parent: Optional[QWidget] = None):
        super().__init__(parent)
        self.setAttribute(Qt.WA_StyledBackground, True)
        self._direction = direction
        self._thickness = thickness
        self._update_size_config()

    def _update_size_config(self):
        if self._direction == Qt.Orientation.Vertical:
            self.setSizePolicy(QSizePolicy.Fixed, QSizePolicy.Expanding)
            self.setFixedWidth(self._thickness)
        else:
            self.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Fixed)
            self.setFixedHeight(self._thickness)

    # 注册direction属性，允许QSS设置
    @pyqtProperty(Qt.Orientation)
    def direction(self):
        return self._direction

    @direction.setter
    def direction(self, value):
        if self._direction != value:
            self._direction = value
            self._update_size_config()

    # 注册thickness属性，允许QSS设置
    @pyqtProperty(int)
    def thickness(self):
        return self._thickness

    @thickness.setter
    def thickness(self, value):
        if self._thickness != value:
            self._thickness = value
            self._update_size_config()

对应的QSS写法：

/* 水平线条：厚度2px，灰色背景 */
Line[direction="Horizontal"] {
    qproperty-thickness: 2;
    background-color: #e0e0e0;
}

/* 垂直线条：厚度3px，深灰色背景 */
Line[direction="Vertical"] {
    qproperty-thickness: 3;
    background-color: #555;
}

二、对比子类方案的优劣 #

你提到的创建HLine和VLine子类的方案虽能实现需求，但存在明显局限：

• 增加类的数量，后续调整样式逻辑时需修改多个类，维护成本高；
• 控件创建后方向固定，无法动态切换；
• 扩展性差，若后续需添加更多自定义属性（如圆角、渐变），会导致代码冗余。

而Q_PROPERTY方案的优势：

• 保持单一Line类，代码结构简洁；
• 支持运行时动态修改属性（通过代码或QSS切换方向/厚度）；
• 样式与逻辑分离更彻底，视觉属性全部由QSS控制，核心布局逻辑留在代码中。

三、极端情况的折中方案 #

如果部分复杂样式确实无法通过QSS实现（如动态计算的尺寸、复杂交互效果），可保留代码中的核心逻辑，仅将视觉相关属性（颜色、厚度、边框等）通过QSS设置，最大化实现样式与代码分离的同时，保证功能完整性。

内容的提问来源于stack exchange，提问作者Jeroen De Geeter