QFont.toString() 的格式是否有文档记录和/或跨 Qt 版本稳定？

Question

的文档QFont.toString说它返回“以逗号分隔的属性列表”，但它没有指定“这些”属性是什么或它们的顺序是什么。 （编辑：文档已更新，因此现在明确列出属性及其顺序。） 我发现了一个老问题，其答案说属性是：

字体系列、pointSizeF、pixelSize、、、、、QFont::StyleHint下划线、strikeOut、fixedPitch、rawModeQFont::WeightQFont::Style

但我找不到此信息的任何权威来源（而且该答案已有 10 多年历史，并且是关于 Qt4 的）。

是否有关于 的格式的明确文档QFont.toString()，包括它代表哪些属性以及它们的顺序？假设保存这样的字符串并稍后QFont.fromString()在不同版本的 Qt 上使用它会起作用，这是否合理？

Answer 1

没有文档指示哪些属性以及它们的序列化顺序。一般来说，Qt 不会指示 Qt 类的序列化顺序，因为它们可能会有所不同，但我认为在 QFont 的情况下，它应该建立一个明确的顺序，因此我建议将其报告为错误。因此，了解顺序的唯一方法是检查源代码：

// https://code.qt.io/cgit/qt/qtbase.git/tree/src/gui/text/qfont.cpp?h=5.15#n2070
QString QFont::toString() const
{
    const QChar comma(QLatin1Char(','));
    QString fontDescription = family() + comma +
        QString::number(     pointSizeF()) + comma +
        QString::number(      pixelSize()) + comma +
        QString::number((int) styleHint()) + comma +
        QString::number(         weight()) + comma +
        QString::number((int)     style()) + comma +
        QString::number((int) underline()) + comma +
        QString::number((int) strikeOut()) + comma +
        QString::number((int)fixedPitch()) + comma +
        QString::number((int)   false);

    QString fontStyle = styleName();
    if (!fontStyle.isEmpty())
        fontDescription += comma + fontStyle;

    return fontDescription;
}

我认为，如果格式发生变化，Qt 将实现逻辑，以便以与 QDataStream 类似的方式支持所有格式，因此一般来说您不必担心它。