在Qt Designer中为Python自定义控件属性编辑器显示枚举选项

要让自定义枚举在Qt Designer属性编辑器中显示为下拉选项，核心是让Qt的元对象系统正确识别枚举类型，以下是可行的实现步骤：

关键修正点 #

Python标准库的Enum无法直接被Qt元对象系统识别，需要结合Qt的Q_ENUM机制，将枚举注册到控件的元对象中，同时调整属性的定义方式。

修正后的代码示例 #

方案1：使用Qt兼容的枚举类型（推荐） #

直接让枚举继承int，确保Qt能直接识别类型，再通过Q_ENUM注册到控件元对象：

from qtpy.QtCore import Property, Q_ENUM
from qtpy.QtWidgets import QCheckBox

class EasingCurveEnum(int):
    Option1 = 0
    Option2 = 1
    Option3 = 2

class QCustomCheckBox(QCheckBox):
    # 将枚举注册到控件的元对象系统
    Q_ENUM(EasingCurveEnum)
    
    def __init__(self, parent=None):
        super().__init__(parent)
        self._easing_curve = EasingCurveEnum.Option1

    @Property(EasingCurveEnum, designable=True)
    def animationEasingCurve(self):
        return self._easing_curve
    
    @animationEasingCurve.setter
    def animationEasingCurve(self, curve):
        self._easing_curve = curve

方案2：兼容Python标准Enum #

如果坚持使用Python标准Enum，需在属性中转换为int类型，并注册枚举到元对象：

from qtpy.QtCore import Property, Q_ENUM
from qtpy.QtWidgets import QCheckBox
from enum import Enum

class EasingCurveEnum(Enum):
    Option1 = 0
    Option2 = 1
    Option3 = 2

class QCustomCheckBox(QCheckBox):
    # 注册枚举到元对象
    Q_ENUM(EasingCurveEnum)
    
    def __init__(self, parent=None):
        super().__init__(parent)
        self._easing_curve = EasingCurveEnum.Option1

    # Property使用int类型，在getter/setter中完成枚举与整数的转换
    @Property(int, designable=True)
    def animationEasingCurve(self):
        return self._easing_curve.value
    
    @animationEasingCurve.setter
    def animationEasingCurve(self, value):
        self._easing_curve = EasingCurveEnum(value)

额外注意事项 #

• 确保自定义控件已正确注册到Qt Designer：需编写插件脚本并配置Qt Designer加载该插件，否则控件本身不会出现在Designer的控件面板中。
• 枚举值必须是整数类型，Qt元对象系统仅支持整数基类型的枚举。
• qtpy已兼容PyQt和PySide系列，代码无需额外修改即可跨框架使用。

内容的提问来源于stack exchange，提问作者Spinn