Quick Controls 2.0 のソースを調べているときに、ドキュメントに見当たらない独特のコメント構文を見つけました。
//! [property]
property: ...
...
//! [property]
たとえば、 のペアは//! [contentItem]
に//! [background]
見られTabButton.qml
ます。
これは、開発者がコードの領域を区切るために選択した慣習にすぎないのでしょうか、それとも特別な意味があるのでしょうか?
Quick Controls 2.0 のソースを調べているときに、ドキュメントに見当たらない独特のコメント構文を見つけました。
//! [property]
property: ...
...
//! [property]
たとえば、 のペアは//! [contentItem]
に//! [background]
見られTabButton.qml
ます。
これは、開発者がコードの領域を区切るために選択した慣習にすぎないのでしょうか、それとも特別な意味があるのでしょうか?
以前はQt クイック コントロールのカスタマイズドキュメント ページにサンプル コード スニペットがありましたが、これらは qdoc マーカーを使用して独自の QML コードから自動的に抽出されました。
で始まる Qt のコメントは、!
ドキュメントを生成するために解析されます。これは、単一行および複数行のコメントに適用されます。
この特定のケースでは、実際のドキュメントは含まれていないようですが、個々の実装の詳細が開始および終了する行を示すために使用されます。
ドキュメント形式の詳細については、こちらをご覧ください。