FAQ: Revit マクロ

このセクションでは、Revit マクロについてよくある質問について回答します。

質問	回答
新しく作成したマクロがマクロマネージャの分類リストに表示されるものと期待しましたが、表示されません。なぜでしょうか。	新しいマクロがマクロマネージャに表示されるには、Revit マクロ IDE でマクロプロジェクトが正しくビルドされている必要があります([ビルド]メニューを使用)。
新しいマクロを作成するときに RevitAPI.dll および RevitAPIUI.dll を参照として追加する必要がありますか。	いいえ、この手順は完了しているため、RevitAPI.dll ファイルと RevitAPIUI ファイルを参照する必要はありません。Revit マクロプロジェクトでは、どちらも必要な参照として使用されます。次のように、IDE でこれらの参照を削除すると、Revit のマクロは実行されません。「RevitAPI.dll および RevitAPIUI.dll を復元する」を参照してください。
Revit.ini ファイルを編集する必要がありますか。	いいえ。Revit マクロは、システムを修正しなくても、マクロマネージャに表示されるよう自動的に登録されます。
Revit マクロ IDE で、This.cs ファイルまたは This.vb ファイル内で対応するメソッドを削除してマクロを削除しました。しかし、マクロマネージャの分類リストを再度開くと、削除したマクロの名前がまだ表示されます。この名前をリストから消すにはどうすればよいでしょうか。	マクロマネージャが削除を認識する前に、編集したプロジェクトを正しくビルドしておく必要があります。
アプリケーションレベルマクロとドキュメントレベルマクロの違いは何ですか。	アプリケーションレベルマクロは、Revit アプリケーションの単一インスタンス内のすべての開かれている Revit プロジェクトで実行できます。ドキュメントレベルマクロプロジェクトは、RVT ファイル内に格納されています。現在のアクティブなドキュメント内からロードでき、そのドキュメント上で実行できます。
`Application` オブジェクトまたは相当する `externalCommandData` にアクセスするにはどうすればよいですか。	すべてのアプリケーションレベルマクロが、`UIApplication` オブジェクトに関連付けられています。アプリケーションレベルマクロでは、C# および VB.NET の `Application` キーワードポインタが API `Application` オブジェクトを返します。ドキュメントレベルマクロでは、`Document` キーワードが API Document オブジェクトを返します。ドキュメントレベルマクロから `UIApplication` オブジェクトにアクセスするには、`this.Application` を使用してください。
スタートアップおよびシャットダウンメソッド(`Module_Startup` および `Module_Shutdown`)には何を含める必要がありますか。	`Module_Startup` メソッドはモジュールのロード時に呼び出され、`Module_Shutdown` はモジュールのアンロード時に呼び出されます。アプリケーションレベルマクロモジュールの場合、Revit の起動時に `Module_Startup` が呼び出され、Revit のシャットダウン時に `Module_Shutdown` が呼び出されます。ドキュメントレベルマクロモジュールの場合、Revit プロジェクトを開いたときに `Module Startup` が呼び出され、プロジェクトドキュメントを閉じたときに `Module_Shutdown` が呼び出されます。 `Module_Startup` および `Module_Shutdown` は、マクロプロジェクトの再ビルド時にも呼び出されます。 `Module_Startup` メソッドにはコードの初期化を追加し、`Module_Shutdown` メソッドではクリーンアップ作業を実行できます。たとえば、起動時にイベントハンドラを登録し、シャットダウン時に登録を解除することができます(この方法をお勧めします)。
Revit イベントハンドラを登録および登録解除する方法およびその理由について教えてください。	前述のとおり、Revit IDE でこれを行う場合は、`_Startup` メソッドでイベントハンドラを登録し、`_Shutdown` メソッドで登録を解除する方法をお勧めします。すべてのマクロが、動的にロードされてロード解除されます。マクロをデバッグするときに、イベントハンドラが正しく登録解除されていないと、Revit によって、間違ったメソッド(おそらくは無効なメモリアドレス)が呼び出される可能性があります。Revit IDE ではこうした状況で Revit がクラッシュすることを防ぎますが、正しく登録解除されていないイベントハンドラがあると、それによって現在の Revit セッション中にパフォーマンスの問題が発生する場合があります。
正しく動作していないように見え、Revit で問題を引き起こしているダイアログがあります。	実行中の API コールバックの範囲外で動作するモードレスダイアログは、問題を引き起こす可能性があります。Revit が不安定な状態になるのを避けるために、このようなコールバックは使用しないことをお勧めします。
Startup および Shutdown メソッドとイベントハンドラを試してみたいと思います。何か例はありますでしょうか。	次のサンプルコードに、新しい Revit プロジェクトが作成されたときにメッセージボックスを自動的に起動する `OnDocumentNewed` イベントハンドラを登録する方法が示されています。注: Revit SDK に付属するマクロサンプルの 1 つに、ドキュメントレベルイベントハンドラのスタートアップとシャットダウンの例を示すものがあります。この FAQ に示す例は、アプリケーションレベルイベントハンドラです。すべての API イベントは、2011 の Revit IDE からアクセスできる点に注意してください。2011 より前のイベントは削除されています。次の例は、新しいイベントを示しています。
Python で作成したマクロが動作しなくなったのはなぜですか?	Python のマクロには .NET Framework 3.5 が必要です。これは、既定ではインストールされません。Python マクロを実行するには、.NET Framework 3.5 を手動でインストールします。

C# アプリケーションレベルの例:

private void Module_Startup(object sender, EventArgs e)
{
   this.Application.DocumentOpened
      += new EventHandler<Autodesk.Revit.DB.Events.DocumentOpenedEventArgs>(Application_DocumentOpened);
}

private void Module_Shutdown(object sender, EventArgs e)
{
   this.Application.DocumentOpened
      -= new EventHandler<Autodesk.Revit.DB.Events.DocumentOpenedEventArgs>(Application_DocumentOpened); 
}

void Application_DocumentOpened(object sender, Autodesk.Revit.DB.Events.DocumentOpenedEventArgs e)
{ 
   System.Windows.Forms.MessageBox.Show("message here");
}

VB.NET アプリケーションレベルの例:

Private
Sub Module_Startup(ByVal sender As Object, ByVal e As System.EventArgs)
Handles Me.StartupAddHandler Me.OnDocumentNewed,
AddressOf Me.ThisApplication_OnDocumentNewed
End SubPrivate Sub Module_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Shutdown 
RemoveHandler Me.OnDocumentNewed,
AddressOf Me.ThisApplication_OnDocumentNewed
End SubPrivate Sub ThisApplication_OnDocumentNewed(ByVal document As Autodesk.Revit.Document) 
System.Windows.Forms.MessageBox.Show("VB.NET
Application event OnDocumentNewed")
End Sub