アドインを作成する


Microsoft の開発ツール Visual Studio を使用して、以下の手順で新しいアドインを作成することができます。
ここでは、サンプルとしてメッセージボックスを表示するアドインを作成します。

アドインのプロジェクトを作成する

  1. RootPro CAD Professional を起動して、[アドイン] - [Visual Studio を起動] メニューをクリックする
    Visual Studio が起動します。Visual Studio がインストールされていない場合は、Microsoft の Visual Studio ホームページが表示されるので、無償で公開されている「Visual Studio Community 2022」をダウンロードしてインストールしてください。
  2. Visual Studio の [ファイル] - [新規作成] - [プロジェクト] メニュー、または [ファイル] - [新しいプロジェクト] メニューをクリックする
    [新しいプロジェクト] ダイアログボックスが表示されます。
  3. [新しいプロジェクト] ダイアログボックスに .NET Framework の対象バージョンを選択するボックスが表示されている場合は [.NET Framework 4.6.2] を選択する
  4. [テンプレートの検索] ボックス、または [検索] ボックスに [RootPro CAD] と入力して検索し、一覧から [RootPro CAD アドイン (C#)] (または [RootPro CAD アドイン (VB)])を選択する
  5. [名前] にアドインのプロジェクト名を入力する
    任意の半角英数文字を入力します。たとえば、円を作成するアドインの場合は「RootProCADAddInCircle」などの名前を指定します。
  6. [OK] をクリックする
    プロジェクトが作成されます。

コードを記述する

  1. プロジェクトが作成されると AppAddIn.cs ファイル (VB の場合は AppAddIn.vb) が自動的に表示されるので、AppAddIn_Startup 関数内に以下のコードを追加する
    【C# の場合】
    private void AppAddIn_Startup(object sender, EventArgs e)
    {
        // 以下の一行を追加します
        MessageBox.Show("アドインを読み込みました。");
    }
    
    【Visual Basic の場合】
    Private Sub AppAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
        ' 以下の一行を追加します
        MessageBox.Show("アドインを読み込みました。")
    End Sub
    

ビルドを実行して、アドインファイル (拡張子.dll) を生成する

  1. [ビルド] - [ソリューションのビルド] メニューをクリックする
    プロジェクトのビルドが実行されて、アドインのファイル (拡張子.dll) が生成されます。
  2. [出力] ウィンドウ、または [エラー一覧] ウィンドウにエラーが表示される場合は、コードの記述に誤りがあります。コードを見直して、再度ビルドを実行してください。

デバッグ実行して、アドインが正常に動作するかを確認する

  1. ビルドが成功したら、[デバッグ] - [デバッグの開始] メニューをクリックする
    RootPro CAD が起動します。
  2. RootPro CAD の [アドイン] - [アドインの管理] メニューをクリックする
    [アドイン/スクリプトの管理] ダイアログボックスが表示されます。
  3. 左側のメニューで [アドイン] - インストール済み] を選択すると、アドイン一覧に作成したアドインが表示されるので、[有効化] をクリックする
  4. [閉じる] をクリックする
    作成したアドインが RootPro CAD に読み込まれます。
    正常に読み込まれた場合は、コードで追加した「アドインを読み込みました。」というメッセージボックスが表示されます。
  5. アドインが正常に動作することを確認したら、RootPro CAD を終了する
  6. Visual Studio を終了する

アドインのプロジェクトの保存場所

アドインのプロジェクトの保存場所は、プロジェクトを新規作成するときに表示される [新しいプロジェクト] ダイアログボックスで指定できます。
アドインのコードを変更したい場合は、Visual Studio を起動して、このフォルダ内のソリューションファイル (拡張子 .sln) を開きます。

作成したアドインを他のコンピューターで使用する

  1. アドインがインストールされているフォルダを他のコンピューターへコピーする
    アドインがインストールされているフォルダは、ドキュメントフォルダの [RootPro CAD\AddIns] 内のアドイン名と同じフォルダです。
    このフォルダを他のコンピューターの同じ場所にコピーします。
  2. コピー先のコンピューターで RootPro CAD を起動して、[アドイン] メニューの [アドインの管理] をクリックする
    [アドイン/スクリプトの管理] ダイアログボックスが表示されます。
  3. アドインの一覧にコピーしたアドインが表示されるので、[有効化] をクリックする
  4. [閉じる] をクリックする
    アドインが読み込まれて、アドインを実行できるようになります。

作成したアドインを削除する

  1. RootPro CAD の [アドイン] - [アドインの管理] メニューをクリックする
    [アドイン/スクリプトの管理] ダイアログボックスが表示されます。
  2. 左側のメニューで [アドイン] - インストール済み] を選択して、アドイン一覧で削除したいアドインの [アンインストール] をクリックする
  3. [閉じる] をクリックする
  4. RootPro CAD を再起動する
  5. 補足
    Windows のエクスプローラーでアドインがインストールされているフォルダを削除することでも、不要になったアドインを削除することができます。
    アドインがインストールされているフォルダは、ドキュメントフォルダの [RootPro CAD\AddIns] 内のアドイン名と同じフォルダです。
    このフォルダを削除することで、アドインを完全に削除することができます。
補足
アドインは、RootPro CAD Professional の機能です。RootPro CAD Free では使用できません。

関連トピック