如何让QDoubleSpinBox的后缀可编辑以支持自定义公制距离输入？

QDoubleSpinBox默认通过setSuffix()添加的后缀是静态显示文本，无法被编辑。要实现支持输入带公制单位的距离（如3.123 mm、2.1 um），需要自定义子类并重写关键文本处理虚函数，完成输入解析、数值转换和格式化显示的逻辑。

核心思路 #

• 自定义继承QDoubleSpinBox的子类，维护支持的公制单位及与基准单位（如米）的转换系数
• 重写validate()方法，校验输入文本是否符合「数值+单位」的格式
• 重写valueFromText()方法，将用户输入的带单位文本转换为基准单位数值存储
• 重写textFromValue()方法，将存储的基准单位数值转换为当前选中单位的带格式文本显示
• 提供单位切换接口，方便用户切换显示单位

Python（PyQt5/PySide2）代码示例 #

from PyQt5.QtWidgets import QDoubleSpinBox, QApplication
from PyQt5.QtGui import QValidator
import re

class MetricDoubleSpinBox(QDoubleSpinBox):
    def __init__(self, parent=None):
        super().__init__(parent)
        self._current_unit = "m"
        # 公制单位到米的转换系数映射
        self._unit_conversion = {
            "um": 1e-6,
            "mm": 1e-3,
            "cm": 0.01,
            "m": 1.0,
            "km": 1000.0
        }
        # 设置基于米的数值范围，可按需调整
        self.setRange(-1e9, 1e9)

    def currentUnit(self):
        return self._current_unit

    def setCurrentUnit(self, unit):
        if unit in self._unit_conversion:
            self._current_unit = unit
            # 更新显示文本
            self.lineEdit().setText(self.textFromValue(self.value()))

    def validate(self, input_str, pos):
        # 正则匹配：正负小数 + 可选单位（支持的公制单位）
        pattern = r'^[-+]?\d*\.?\d*\s*(um|mm|cm|m|km)?$'
        if re.fullmatch(pattern, input_str.strip()):
            return (QValidator.Acceptable, input_str, pos)
        return (QValidator.Invalid, input_str, pos)

    def valueFromText(self, text):
        text = text.strip()
        # 拆分数值和单位部分
        match_result = re.match(r'([-+]?\d*\.?\d+)\s*(um|mm|cm|m|km)?', text)
        if not match_result:
            return 0.0
        
        num_str = match_result.group(1)
        input_unit = match_result.group(2) or self._current_unit  # 无单位时用当前默认单位
        try:
            raw_num = float(num_str)
            conversion_factor = self._unit_conversion.get(input_unit, 1.0)
            # 转换为米为单位的数值存储
            return raw_num * conversion_factor
        except ValueError:
            return 0.0

    def textFromValue(self, value):
        # 将米单位的数值转换为当前单位的数值
        conversion_factor = self._unit_conversion.get(self._current_unit, 1.0)
        converted_num = value / conversion_factor
        # 格式化显示，保留三位小数（可根据需求调整精度）
        return f"{converted_num:.3f} {self._current_unit}"

if __name__ == "__main__":
    app = QApplication([])
    spin_box = MetricDoubleSpinBox()
    spin_box.setCurrentUnit("mm")  # 设置初始显示单位为毫米
    spin_box.show()
    app.exec_()

代码说明 #

1. 单位转换映射：通过字典维护支持的公制单位与米的转换系数，后续可轻松扩展更多单位
2. 输入校验：用正则约束输入格式，避免无效的非数值或非支持单位的输入
3. 数值解析与转换：valueFromText将输入的带单位数值转为米存储，保证数值逻辑的统一性
4. 显示格式化：textFromValue将存储的米数值转为当前单位的文本，带单位友好显示
5. 单位切换：setCurrentUnit方法可随时切换显示单位，已输入的数值会自动适配转换

C++ 实现思路 #

如果使用Qt C++开发，核心逻辑完全一致：

• 继承QDoubleSpinBox，用QMap<QString, double>存储单位转换系数
• 重写QValidator::State validate(QString &input, int &pos) const方法
• 重写double valueFromText(const QString &text) const和QString textFromValue(double value) const方法
• 实现单位切换的成员函数

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