这个问题在这里已有答案:
在查看Quick Controls 2.0源代码时,我发现了一种特殊的注释语法,我似乎无法在docs中找到它:
//! [property] property: ... ... //! [property]
例如,在 TabButton.qml 中可以看到成对的 //! [contentItem] , //! [background] .
TabButton.qml
//! [contentItem]
//! [background]
我想知道这是否只是开发人员选择划分代码区域的惯例,还是它确实具有一些特殊含义?
使用以 ! 开头的Qt注释进行解析以生成文档 . 这适用于单行和多行注释 .
!
但在这种特殊情况下,它似乎不包含任何实际文档,它用于表示各个实现细节开始和结束的行 .
您可以了解有关文档格式here的更多信息 .
在Customizing Qt Quick Controls文档页面上曾经有过示例代码片段,这些代码片段是在qdoc-markers的帮助下从我们自己的QML代码中自动提取的 .
2 回答
使用以
!
开头的Qt注释进行解析以生成文档 . 这适用于单行和多行注释 .但在这种特殊情况下,它似乎不包含任何实际文档,它用于表示各个实现细节开始和结束的行 .
您可以了解有关文档格式here的更多信息 .
在Customizing Qt Quick Controls文档页面上曾经有过示例代码片段,这些代码片段是在qdoc-markers的帮助下从我们自己的QML代码中自动提取的 .