ウォークスルー: Hello World リボンパネルを追加する

ウォークスルー: Hello World セクションでは、アドインアプリケーションの作成方法およびこれを Revit で呼び出す方法を学習します。また、.addin マニフェストファイルを作成して、外部ツールとしてアドインアプリケーションを登録する方法も学習します。Revit でアドインアプリケーションを実行するもう 1 つの方法として、カスタムリボンパネルから実行する方法があります。

新しいプロジェクトを作成する

新しいプロジェクトを作成するには、次の手順を実行します。

クラスライブラリテンプレートを使用して Visual Studio で C# のプロジェクトを作成します。
プロジェクト名として「AddPanel」と入力します。
前のウォークスルーである、ウォークスルー: Hello World の指示を使用して、RevitAPI.dll および RevitAPIUI.dll に参照を追加します。
PresentationCore 参照を追加します。
- [ソリューションエクスプローラ]で、[参照]を右クリックして[コンテキスト]メニューを表示します。
- [コンテキスト]メニューから、[参照の追加]をクリックします。[参照の追加]ダイアログボックスが表示されます。
- [参照の追加]ダイアログボックスで、[.NET]タブをクリックします。
- [コンポーネント名] リストで、[PresentationCore]を選択します。
- [OK]をクリックしてダイアログボックスを閉じます。PresentationCore が[ソリューションエクスプローラ]の参照ツリーに表示されます。
図 8: 参照の追加
WindowsBase 参照および System.Xaml を上と同様の手順で追加します。

クラス名を変更する

クラス名を変更するには、次の手順を実行します。

[クラスビュー]ウィンドウで、[Class1]を右クリックして[コンテキスト]メニューを表示します。
[コンテキスト]メニューから、[名前変更]を選択して、クラスの名前を CsAddPanel に変更します。
[ソリューションエクスプローラ]で、Class1.cs ファイルを右クリックして、コンテキストを表示します。
[コンテキスト]メニューから、[名前変更]を選択して、クラスの名前を CsAddPanel.cs に変更します。
CsAddPanel.cs をダブルクリックして開き、これを編集します。

コードを追加

パネルの追加プロジェクトは、Revit プロジェクトが実行されると自動的に起動されるため、Hello World とは異なります。このプロジェクトには、IExternalApplication インタフェースを使用します。IExternalApplication インタフェースには、2 つの抽象メソッド、OnStartup()および OnShutdown()が含まれます。IExternalApplication の詳細は、「アドインの統合」を参照してください。

リボンパネルに次のコードを追加します。

コード領域 2-5: リボンパネルを追加

using Autodesk.Revit.UI;
using Autodesk.Revit.DB;
using System.Windows.Media.Imaging;  
class CsAddpanel : Autodesk.Revit.UI.IExternalApplication
{
        public Autodesk.Revit.UI.Result OnStartup(UIControlledApplication application)
        {
                // add new ribbon panel
                RibbonPanel ribbonPanel = application.CreateRibbonPanel("NewRibbonPanel");
                
                //Create a push button in the ribbon panel "NewRibbonPanel"
                //the add-in application "HelloWorld" will be triggered when button is pushed
                
                PushButton pushButton = ribbonPanel.AddItem(new PushButtonData("HelloWorld", 
                        "HelloWorld", @"D:\HelloWorld.dll", "HelloWorld.CsHelloWorld")) as PushButton;
 
                // Set the large image shown on button
                Uri uriImage = new Uri(@"D:\Sample\HelloWorld\bin\Debug\39-Globe_32x32.png");
                BitmapImage largeImage = new BitmapImage(uriImage);
                pushButton.LargeImage = largeImage;

                return Result.Succeeded;
        }

        public Result OnShutdown(UIControlledApplication application)
        {
                return Result.Succeeded;
        }
}

アプリケーションの作成

コードの完成後、アプリケーションを作成します。[ビルド]メニューから、[ソリューションのビルド]をクリックします。ビルドの出力が出力ウィンドウに表示され、エラーなしでプロジェクトがコンパイルされたことを表します。AddPanel.dll がプロジェクト出力フォルダに配置されます。

.addin マニフェストファイルの作成

Revit アプリケーションを起動するには、Revit に登録するマニフェストファイルを作成します。

メモ帳を使用して、新しいテキストファイルを作成します。

次のテキストをファイルに追加します。

コード領域 2-6: 外部アプリケーションの .addin ファイルを作成

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<RevitAddIns>
<AddIn Type="Application">
        <Name>SampleApplication</Name>
        <Assembly>D:\Sample\AddPanel\AddPanel\bin\Debug\AddPanel.dll</Assembly>
        <AddInId>604B1052-F742-4951-8576-C261D1993107</AddInId>
        <FullClassName>AddPanel.CsAddPanel</FullClassName>
        <VendorId>ADSK</VendorId>
        <VendorDescription>Autodesk, www.autodesk.com</VendorDescription> 
</AddIn>
</RevitAddIns>

ファイルを HelloWorldRibbon.addin として保存して、次の場所に格納します。
- Windows XP の場合 - C:¥Documents and Settings¥All Users¥Application Data¥Autodesk¥Revit¥Addins¥2012¥
- Vista/Windows 7 の場合 - C:¥ProgramData¥Autodesk¥Revit¥Addins¥2012¥

注: AddPanel.dll ファイルは、デバッグ(D:¥Sample¥HelloWorld¥bin¥Debug¥AddPanel.dll)という名前の新しいフォルダにある既定のファイルフォルダにあります。ファイルパスを使用してアセンブリを評価します。

.addin マニフェストファイルの詳細は、「アドインの統合」を参照してください。

デバッグ

デバッグを開始するには、プロジェクトを構築し、Revit を実行します。新しいリボンパネルが NewRibbonPanel および Hello World という名前の[アドイン]タブに、パネルの唯一のボタンとして大きな地球の画像で表示されます。

図 9: Revit に新しいリボンパネルを追加

[Hello World]をクリックしてアプリケーションを実行し、次のダイアログボックスを表示します。

図 10: [Hello World]ダイアログボックス

ウォークスルー: Hello World リボン パネルを追加する