マクロ マネージャは、次に使用するユーザ インタフェースです。
- Revit マクロ IDE を起動するオプションを選択する。これを起動することで、マクロの追加、編集、構築、デバッグができます。
- 分類リストから構築済みのマクロを実行する。
次に示すのはマクロ マネージャの画面です。
タブは、マクロの範囲またはレベルを示します。
- [アプリケーション]タブ。[アプリケーション]タブには、Revit アプリケーションの現在のインスタンス内で開かれているすべての Revit プロジェクトが使用できるマクロ モジュールが一覧表示されます。常に一番左のタブで、アクティブになっています(
アイコンで示されます)。プロジェクトが開いているときはいつでも使用することができます。 注: RVT ファイルを別のコンピュータ上のユーザに送信すると、アプリケーションレベル マクロは使用できなくなります。 - アクティブなドキュメントのタブ。アクティブなドキュメントのタブは、現在 Revit でアクティブなプロジェクトを表します。プロジェクトには埋め込まれたマクロを含めることができますが、この場合と同じく、マクロを含めなくてもかまいません。タブにはアクティブなプロジェクトの名前が表示され(この場合は Project1)、 アイコンで示されます。プロジェクトが開いていない場合、このタブは表示されません。
- アクティブでないドキュメントのタブ。アクティブでないドキュメントのタブは、開いているプロジェクトのうちマクロが埋め込まれたプロジェクトを表します(次を参照)。タブにはプロジェクトの名前が表示されます(この場合は、Project2 と Project3)。
これらのタブからモジュールおよびマクロを追加、変更、構築、削除します。
マクロとモジュール
モジュールは、マクロを整理するためのグループです。マクロは、モジュール内で独立して実行するか、コードまたはユーティリティを互いに共有することができます。マクロ マネージャで次のように配置され、親モジュールの下にマクロが整理されます。
モジュール内のマクロはともに表示され、構築されます。モジュールを表すアイコンは現在の状態も示しています。
| アイコン | マクロの状態 |
|---|---|
 |
モジュールは正常に構築、有効化、およびロードされました。このモジュールは実行することができます。 |
 |
モジュールは編集されましたが、構築されていません。 |
 |
モジュールは無効です。 |
 |
モジュールの構築に失敗しました。 |
 |
モジュールのロードに失敗しました。 |
 |
モジュールが壊れています。 |
アプリケーション レベル モジュールとドキュメント レベル モジュール
基本的に、アプリケーション レベル マクロ ツールは、ほとんどすべての Revit セッションのすべてのドキュメントで役立つように記述されています。さらに、プロジェクトを Revit で開いていなくても実行できます。これにより、次のような処理を柔軟に行うことができます。
- Revit UI のカスタマイズ
- Revit へのツールの追加
- 開く際のドキュメントの変更
- 開いているドキュメントのバッチ処理
- 新しいドキュメントへの新しい標準または設定の適用
このような使用法を実装する場合は、マクロが必要とするトランザクションを開始するアプリケーションレベル マクロの作成が適切です。
ドキュメントレベル マクロ ツールは、特定のプロジェクト向けに記述されていて、Revit プロジェクト内に保存されます。
Revit マクロの実装言語
Revit では、C#、VB.NET、Ruby、Python といった実装言語を使用してマクロを作成できます。選択した言語によって、Revit マクロ IDE で生成、編集されるソース コード テンプレートの種類が決まります。
マクロ プロジェクト ファイルの場所
Revit マクロ IDE で作業するとき、マクロをマクロ マネージャの分類リストに表示するには、そのマクロの保存と構築を正常に完了する必要があります。Revit マクロ IDE にロードされる初期コードの例を挙げる前に、コンピュータ上に存在するマクロ プロジェクト ファイルの場所について説明します。
アプリケーション レベルおよびドキュメント レベルのマクロ プロジェクトは、Revit のインストール フォルダのサブフォルダに格納されます。
Windows 7 および Windows 8: %ALLUSERSPROFILE%¥Autodesk¥<product name and release>\Macros\<release>\<product>\AppHookup
ドキュメントレベル マクロ プロジェクトは、RVT ファイル内に格納されています。ディスク上において、関連付けられた RVT プロジェクトが開くときには、構築して保存したマクロが、次の場所に一時的に格納されます。ドキュメントレベル マクロ ファイルは、それに対応する Revit プロジェクト ドキュメント(.rvt)が閉じられると、ローカル コンピュータから削除されます。
全体的なツールとプロセスについて説明したので、次に特定のタスクについて説明します。