Revit マクロ IDE に SDK サンプルを移行する

マクロ用の SDK サンプル コードを使用するには、修正が必要です。

Revit SDK には、次の 2 つのサンプル フォルダが入っています。

¥Revit SDK <リリース名>¥Software Development Kit¥Samples¥...

¥Revit SDK <リリース番号>¥Software Development Kit¥Macro Samples¥...

SDK の ¥Samples¥ フォルダにあるプログラムは、標準的な Revit API を使用します。これらのサンプルは SDK サンプル コードと呼び、Revit マクロ サンプルとは区別します。

このセクションにある手順に従います。プログラミング言語用に、C# のサンプルを示します。ただし、これらの命令は、SDK サンプルの VB.NET バージョンにも適用されます。

初期手順

標準的な API サンプルを SDK から Revit マクロ IDE プロジェクトにマイグレーションする初期手順は、「Revit IDE にマクロを統合する」セクションに類似しています。代わりに SDK の ¥Macro Samples¥<sample-name>¥... のフォルダにあるファイルをコピーする以外は、SDK の ¥Samples¥<sample-name>¥... のフォルダからファイルをコピーします。

見直すには、次の手順を実行します。

1. IDE で、必要な参照を追加します。
2. IDE で、マイグレーションする SDK サンプル用のフォルダを作成します。
3. Windows エクスプローラで、SDK 標準 API サンプルのファイルを、対応するファイル システム フォルダにコピーします。
4. IDE で、既存のファイルを、マクロ プロジェクトに追加します。

SDK サンプルのコードを更新する

Revit マクロ IDE では、IExternalCommand インタフェースは使用できません。SDK 標準 API サンプル コードで次の操作を実行して、このインタフェースを継承するクラスを更新する必要があります。

• メソッドのパラメータ、およびExecute メソッドの戻り値を削除します。
• ExternalCommandData に関連する他のコードを更新します。

編集前のコードの例

次のコード断片は、標準的な Revit API を使用するプログラムからのものです。

編集後のコードの例

Revit マクロ IDE では、次のようにコードを更新する必要があります。この例では、アプリケーションレベル マクロを示します。RunSampleRooms() メソッドは、このマクロ サンプル用のエントリです。this ポインタを使用して、commandData.Application を置き換えたことに注目してください。

SDK 標準 API サンプルについての追加のマイグレーション注記

• 既定では、SDK サンプルの名前空間は Revit.SDK.Samples.<サンプル名>.CS です。SDK 標準 API サンプルに由来するサンプル コードを編集する場合には必ず、Revit IDE 用に名前空間を変更してください。たとえば、ThisApplication.cs では、

  namespace AppCSharp.csproj となります。

• Revit IDE プロジェクト内の既定のプロジェクト参照は、Revit.Proxy などの基本参照からのみ構成されます。他の必要な参照も忘れずに追加します。たとえば、ユーザ インタフェースを提示するサンプルを実行する場合には、System.Windows.Forms 参照と System.Drawing 参照を追加する必要があります。
• 一部のサンプルには、resources.resx ファイル内に設定する必要があるリソースがあります。GridCreation はそのサンプルの 1 つです。GridCreation 用の SDK 標準 API サンプルを Revit IDE にマイグレーションする場合には必ず、resx プロパティを設定してください。
• プロジェクト ビルドの依存関係は、Revit マクロ IDE 内ではサポートされません。他の DLL を使用する場合には、Revit マクロ IDE の外部で、その依存するサンプル プロジェクトをコンパイルする必要があります。たとえば、SDK 標準 API サンプルでは、RevitViewer に依存する AnalyticalViewer や RoomViewer などのビューア(Viewer)に関連するサンプルがいくつかあります。

  ただし、Revit IDE の制限により、プロジェクト依存関係は設定できません。また、RevitViewer サンプルは移行できません。したがって、次のように、RevitViewer を独立した SDK サンプルとしてコンパイルし、その後その DLL を Revit IDE プロジェクト内の参照として追加します。

• SDK 標準 API サンプルを Revit IDE にマイグレーションする場合には、いかなるソリューション ファイル(*.sln*)や既存のプロジェクト ファイル(*.csproj や *.vbproj)もコピーしないでください。
• ツールバー関連のサンプルは、Revit IDE では使用できません。