奇怪的 //! 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 代码中自动提取的。
在查看 Quick Controls 2.0 源代码时,我发现了一种我在文档中似乎找不到的特殊注释语法:
//! [property]
property: ...
...
//! [property]
例如,//! [contentItem]
、//! [background]
对可以在 TabButton.qml
中看到。
不知道这只是开发者为了划分代码区域而选择的约定,还是真的有什么特殊的含义?
以 !
开头的 Qt 注释被解析以生成文档。这适用于单行和多行注释。
但在这种特殊情况下,它似乎不包含任何实际文档,它用于表示各个实现细节开始和结束的行。
您可以了解更多关于文档格式的信息here。
Customizing Qt Quick Controls 文档页面上曾经有示例代码片段,它们是在那些 qdoc-markers 的帮助下从我们自己的 QML 代码中自动提取的。