奇怪的 //！ Quick Controls 2.0 QML 源代码中的注释语法 [重复]

Posted 2023-02-21

【中文标题】奇怪的 //！ Quick Controls 2.0 QML 源代码中的注释语法 [重复]

【英文标题】：Strange //! comment syntax in Quick Controls 2.0 QML source [duplicate]

【发布时间】：2017-03-13 20:00:50

【问题描述】：

在查看 Quick Controls 2.0 源代码时，我发现了一种在文档中似乎找不到的特殊注释语法：

//! [property]
property: ...
...
//! [property]

例如，//! [contentItem]、//! [background] 对可以在 TabButton.qml 中看到。

---

我想知道这是否只是开发人员选择的用于划分代码区域的约定，还是确实有什么特殊含义？

【问题讨论】：

是的，绝对是重复的......但为了我的辩护，我确实在提问之前尝试过找到答案。关于如何在 SO（以及谷歌搜索）上搜索短字符串的任何建议？搜索 [qml] "//!" 给了我零个结果。

我也没找到 ;)

【参考方案1】：

Customizing Qt Quick Controls 文档页面上曾经有示例代码 sn-ps，这些示例代码是在这些 qdoc 标记的帮助下从我们自己的 QML 代码中自动提取的。

【参考方案2】：

使用以! 开头的 Qt cmets 被解析以生成文档。这适用于单行和多行 cmets。

然而，在这个特殊情况下，它似乎不包含任何实际文档，它用于表示各个实现细节开始和结束的行。

您可以详细了解文档格式here。