Strange //！クイックコントロールでのコメント構文2.0 QMLソース

クイックコントロール2.0のソースを見ている間、私はドキュメントで見つけることができないよう特殊なコメント構文に出くわしました：、//! [contentItem]のペア、例えばStrange //！クイックコントロールでのコメント構文2.0 QMLソース

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

//! [background]はTabButton.qmlに見られます。

これはコードの領域を区切るために、開発者によって選ばれただけで慣例である、またはそれは確かにいくつかの特別な意味を持っているんだろうか？

2016-10-31 sunny moon

確かに重複...しかし、私の防衛には、私は確かに尋ねる前に答えを見つけようとしました。私はどのように短い文字列を検索するのですか？ '[qml]" //！ "'を検索するとゼロの結果が得られました。 –

私はそれを見つけられませんでした;） – dtech

!で始まるQtコメントは、ドキュメントを生成するために解析されます。これは、単一または複数の行コメントに適用されます。

この特定のケースでは実際のドキュメントは含まれていないようですが、個々の実装の詳細が始まり終わる行を示すために使用されています。

ドキュメント形式hereについて詳しく知ることができます。

2016-10-31 17:27:02 dtech

Customizing Qt Quick Controlsのマニュアルページには、以前はqdoc-markersの助けを借りて独自のQMLコードから自動的に抽出されたコードスニペットがありました。

2016-10-31 17:39:29 jpnurmi

答えて