Show page source of Q&A #52967

== Q & A == #top

 1. 処理されたVisual Basic プロジェクトに条件付きコンパイルされるステートメント(Sub , Functionなど)があった場合、どうなるでしょうか?
 2. XML形式でドキュメント用コメントを書いたのですが、レポートに出力されない理由を教えてください。
 3. レポートに出力されるクラス一覧を変更することは可能でしょうか?
 4. 自分でレポートマネージャを作ることは可能でしょうか?
 5. ファイルの中で最も最初の宣言に対するドキュメント用コメントが、モジュールの説明としてレポートに出力されるの理由を教えてください。
 6. Visual Basicの機能のうち、サポートしていないものを教えてください。

----

'''Q''' 処理されたVisual Basic プロジェクトに条件付きコンパイルされるステートメント(Sub , Functionなど)があった場合、どうなるでしょうか?

'''A''' 現在(Version 0.0.21)、条件付コンパイルは考慮されません。生成結果には全ての宣言が出力されます。宣言(Sub , Functionなど)のみが重複する場合、最も上に定義しているものがレポートに出力されます。

[#top << トップへ]

'''Q''' XML形式でドキュメント用コメントを書いたのですが、レポートに出力されない理由を教えてください。

'''A''' もし、VBDOXのVersionが1.1.XXより低いものを使用しているのであれば、これはXML形式のドキュメント用コメントはXML形式でレポートを出力するために作られているためです(※たぶん、「早い話、仕様です」ということ)。

Version 1.1.xxから、[XMLドキュメント用コメントの書き方]のページで示した形式に沿ったXML形式のコメントは解析されます。そして、XMLレポートマネージャ以外のレポートマネージャで使用できます。

少しでもXML形式のコメントでないものは解析に使用されないことに再度注意してください。

[#top << トップへ]

'''Q''' レポートに出力されるクラス一覧を変更することは可能でしょうか?

'''A''' できません。標準のレポートでは全てのクラスを出力するか、publicクラスのみとするかの選択のみ可能です。

[#top << トップへ]

'''Q''' 自分でレポートマネージャを作ることは可能でしょうか?

'''A''' 必要であれば、可能です。Version 1.0.34以降、VBDOXのソースを必要としなくなりました。

作成したレポートマネージャとパーサは容易に作成可能です。そして、それをVBDOXから使用することができます。両方とも外部ActiveX (COM)コンポーネントとして実装されます。実際、配布されたレポートマネージャとパーサもそうなっています。それらについてはソースのVBDOXEXTに含まれています。作成方法については[開発者へ]を見てください。

最も簡単に独自のレポートを作成する方法は、プログラムで生成されたXMLに対してXSLT変換を行うことです。

[#top << トップへ]

'''Q''' ファイルの中で最も最初の宣言に対するドキュメント用コメントが、モジュールの説明としてレポートに出力されるの理由を教えてください。

'''A''' モジュールの一番上に来るドキュメント用のコメントは常にモジュールレベルのコメントであると考えられます。このため、モジュールレベルのドキュメント用コメントがあることが必要となっています。

[#top << トップへ]

'''Q''' Visual Basicの機能のうち、サポートしていないものを教えてください。

'''A''' 現在、把握している限りでは、以下があります。
 * 条件付きポンパイル(Q1)
 * {{{DefXXX}}} ステートメント(例:{{{DefBool}}})
 * {{{Option Private Module}}}
 * 配列を返す関数(Version 1.1.xx以前)

もし、他に見つけたら、教えてください。

[#top << トップへ]

このドキュメントは[http://vbdox.sourceforge.net/QA.html VODOX]のサイトを元に作成しました