dumpcppツール（ActiveQt）

dumpcpp ツールは、タイプ・ライブラリの C++ 名前空間を生成します。

タイプ・ライブラリのC++名前空間を生成するには、以下のコマンドライン・パラメーターを指定してdumpcpp ：

型ライブラリが変更されることはめったにないため、このツールを手動で実行すれば（そしておそらく、生成されたファイルをバージョン管理システムでチェックすれば）、通常は十分である。型ライブラリが頻繁に変更される場合は、dumpcpp をqmake ビルド・システムに統合すればよい。.proファイルのTYPELIBS変数に、使用したい型ライブラリを列挙してください：

TEMPLATE = app
TARGET   = qutlook
QT += widgets axcontainer

TYPELIBS = $$system(dumpcpp -getfile {00062FFF-0000-0000-C000-000000000046})

生成された名前空間は、すべての列挙と、型ライブラリで宣言されたcoclass 、interface ごとに1つのQAxObject サブクラスを宣言します。control 属性でマークされたコクラスは、QAxWidget サブクラスによってラップされます。

作成可能なコクラスをラップするこれらのクラス（つまり、noncreatable としてマークされていないコクラス）は、デフォルトのコンストラクタを持ちます。これは通常、Application 型の単一のクラスです。

Outlook::Application *outlook = new Outlook::Application;

それ以外のクラスは、IDispatchインターフェース・ポインターをコンストラクタに渡すことによってのみ作成できます。代わりに、すでに作成されているオブジェクトの適切なAPIを使用してください。

Outlook::_NameSpace *session = outlook->Session();

すべてのコクラス・ラッパーは、実装されたインターフェースごとにインターフェース・ラッパー・クラスを取るコンストラクターも1つ持っています。

Outlook::NameSpace *session = outlook->Session();

サブオブジェクトのシグナルに接続できるようにするために、コクラスを作成する必要があります。コンストラクターはインターフェイスオブジェクトを削除するので、次のようにするとセグメンテーションフォールトが発生することに注意：

Outlook::_NameSpace *tmp = outlook->Session();
Outlook::NameSpace *session = new Outlook::NameSpace(tmp);
delete tmp; // or any other use of tmp: segfault

戻り値の型が他の型ライブラリで宣言されたコクラスまたはインターフェース型の場合、使用したい名前空間のヘッダをインクルードする前に、他の型ライブラリの名前空間ヘッダをインクルードする必要があります（両方のヘッダをこのツールで生成する必要があります）。

デフォルトでは、サブオブジェクトを返すメソッドとプロパティは、型ライブラリと同じ型を使用します。関数の呼び出し側は、返されたオブジェクトの削除や再保護を行う責任があります。-compat スイッチが設定されている場合、COM オブジェクトを返すプロパティとメソッドは返り型IDispatch* を持ち、ネームスペースはインタフェースのラッパークラスを宣言しません。

この場合、正しいラッパークラスを明示的に作成します：

Outlook::NameSpace *session = new Outlook::NameSpace(outlook->Session());

もちろん、返された IDispatch* を直接使用することもできますが、その場合、インタフェースの処理が終了したときにRelease() を呼び出す必要があります。

名前空間内のすべてのクラスには、DLLからエクスポートまたはインポートできるマクロが付けられています。これを行うには、ヘッダー・ファイルをインクルードする前に、__declspec(dllimport/export) に展開するマクロを宣言します。

ツールをビルドするには、まずQAxContainer ライブラリをビルドする必要があります。次に、tools/dumpcpp で make ツールを実行します。