アドインを作成する
Microsoft の開発ツール Visual Studio を使用して、以下の手順で新しいアドインを作成することができます。
ここでは、サンプルとしてメッセージボックスを表示するアドインを作成します。
アドインのプロジェクトを作成する
- RootPro CAD Professional を起動して、[アドイン] - [Visual Studio を起動] メニューをクリックする
Visual Studio が起動します。Visual Studio がインストールされていない場合は、Microsoft の Visual Studio ホームページが表示されるので、無償で公開されている「Visual Studio Community 2022」をダウンロードしてインストールしてください。
- Visual Studio の [ファイル] - [新規作成] - [プロジェクト] メニュー、または [ファイル] - [新しいプロジェクト] メニューをクリックする
[新しいプロジェクト] ダイアログボックスが表示されます。 - [新しいプロジェクト] ダイアログボックスに .NET Framework の対象バージョンを選択するボックスが表示されている場合は [.NET Framework 4.6.2] を選択する
- [テンプレートの検索] ボックス、または [検索] ボックスに [RootPro CAD] と入力して検索し、一覧から [RootPro CAD アドイン (C#)] (または [RootPro CAD アドイン (VB)])を選択する
- [名前] にアドインのプロジェクト名を入力する
任意の半角英数文字を入力します。たとえば、円を作成するアドインの場合は「RootProCADAddInCircle」などの名前を指定します。 - [OK] をクリックする
プロジェクトが作成されます。
コードを記述する
- プロジェクトが作成されると AppAddIn.cs ファイル (VB の場合は AppAddIn.vb) が自動的に表示されるので、AppAddIn_Startup 関数内に以下のコードを追加する
【C# の場合】
【Visual Basic の場合】private void AppAddIn_Startup(object sender, EventArgs e) { // 以下の一行を追加します MessageBox.Show("アドインを読み込みました。"); }
Private Sub AppAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup ' 以下の一行を追加します MessageBox.Show("アドインを読み込みました。") End Sub
ビルドを実行して、アドインファイル (拡張子.dll) を生成する
- [ビルド] - [ソリューションのビルド] メニューをクリックする
プロジェクトのビルドが実行されて、アドインのファイル (拡張子.dll) が生成されます。 - [出力] ウィンドウ、または [エラー一覧] ウィンドウにエラーが表示される場合は、コードの記述に誤りがあります。コードを見直して、再度ビルドを実行してください。
デバッグ実行して、アドインが正常に動作するかを確認する
- ビルドが成功したら、[デバッグ] - [デバッグの開始] メニューをクリックする
RootPro CAD が起動します。 -
RootPro CAD の [アドイン] - [アドインの管理] メニューをクリックする
[アドイン/スクリプトの管理] ダイアログボックスが表示されます。 - 左側のメニューで [アドイン] - インストール済み] を選択すると、アドイン一覧に作成したアドインが表示されるので、[有効化] をクリックする
- [閉じる] をクリックする
作成したアドインが RootPro CAD に読み込まれます。
正常に読み込まれた場合は、コードで追加した「アドインを読み込みました。」というメッセージボックスが表示されます。 - アドインが正常に動作することを確認したら、RootPro CAD を終了する
- Visual Studio を終了する
アドインのプロジェクトの保存場所
アドインのプロジェクトの保存場所は、プロジェクトを新規作成するときに表示される [新しいプロジェクト] ダイアログボックスで指定できます。
アドインのコードを変更したい場合は、Visual Studio を起動して、このフォルダ内のソリューションファイル (拡張子 .sln) を開きます。
作成したアドインを他のコンピューターで使用する
- アドインがインストールされているフォルダを他のコンピューターへコピーする
アドインがインストールされているフォルダは、ドキュメントフォルダの [RootPro CAD\AddIns] 内のアドイン名と同じフォルダです。
このフォルダを他のコンピューターの同じ場所にコピーします。 - コピー先のコンピューターで RootPro CAD を起動して、[アドイン] メニューの [アドインの管理] をクリックする
[アドイン/スクリプトの管理] ダイアログボックスが表示されます。 - アドインの一覧にコピーしたアドインが表示されるので、[有効化] をクリックする
- [閉じる] をクリックする
アドインが読み込まれて、アドインを実行できるようになります。
作成したアドインを削除する
- RootPro CAD の [アドイン] - [アドインの管理] メニューをクリックする
[アドイン/スクリプトの管理] ダイアログボックスが表示されます。 - 左側のメニューで [アドイン] - インストール済み] を選択して、アドイン一覧で削除したいアドインの [アンインストール] をクリックする
- [閉じる] をクリックする
- RootPro CAD を再起動する
補足 | |
・ | Windows のエクスプローラーでアドインがインストールされているフォルダを削除することでも、不要になったアドインを削除することができます。 アドインがインストールされているフォルダは、ドキュメントフォルダの [RootPro CAD\AddIns] 内のアドイン名と同じフォルダです。 このフォルダを削除することで、アドインを完全に削除することができます。 |
補足 | |
・ | アドインは、RootPro CAD Professional の機能です。RootPro CAD Free では使用できません。 |