奇怪的 //! Quick Controls 2.0 QML 源中的注释语法

Strange //! comment syntax in Quick Controls 2.0 QML source

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

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

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


不知道这只是开发者为了划分代码区域而选择的约定,还是真的有什么特殊的含义?

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

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

您可以了解更多关于文档格式的信息here

Customizing Qt Quick Controls 文档页面上曾经有示例代码片段,它们是在那些 qdoc-markers 的帮助下从我们自己的 QML 代码中自动提取的。