qt - 奇怪的 //！Quick Controls 2.0 QML 源代码中的注释语法

Question

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

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

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

---

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

Answer 1

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

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

您可以在此处了解有关文档格式的更多信息。

Answer 2

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