チュートリアル : 初めての Project 用アプリケーション レベルのアドインの作成
このチュートリアルでは、Microsoft Office Project 用のアプリケーション レベルのアドインを作成する方法について説明します。この種のソリューションに作成した機能は、どのプロジェクトが開いているかにかかわらず、アプリケーション自体に対して使用できます。詳細については、「Office ソリューションの開発の概要」を参照してください。
対象: このトピックの情報は、Project 2013 と Project 2010 のアプリケーション レベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクト タイプ別の使用可能な機能」を参照してください。
このチュートリアルでは、次の作業について説明します。
Project アドイン プロジェクトを作成する。
Project のオブジェクト モデルを使用して、新しいプロジェクトにタスクを追加するコードを記述する。
プロジェクトをビルドし、実行してテストする。
完成したプロジェクトをクリーンアップして、開発用コンピューターでこのアドインが自動的に実行されないようにする。
[!メモ]
お使いのマシンで、Visual Studio ユーザー インターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。
必須コンポーネント
このチュートリアルを実行するには、次のコンポーネントが必要です。
-
Microsoft Office Developer Tools が含まれているエディションの Visual Studio 2012。詳細については、「[Office ソリューションを開発できるようにコンピューターを構成する](bb398242\(v=vs.110\).md)」を参照してください。
- Project 2013 または Project 2010。
プロジェクトの作成
Visual Studio で、新しいプロジェクトを作成するには
Visual Studio を起動します。
[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
テンプレート ペインで、または [Visual C#] **[Visual Basic]を展開し、[Office/SharePoint]**を展開します。
[Office/SharePoint] の展開したノードの下で、[Office Add-ins] のノードを選択します。
プロジェクト テンプレートの一覧で、[Project 2010 アドイン] または [Project 2013 アドイン] を選択します。
[プロジェクト名] ボックスに「FirstProjectAddIn」と入力します。
[OK] をクリックします。
Visual Studio により FirstProjectAddIn プロジェクトが作成され、ThisAddIn コード ファイルがエディターで開かれます。
プロジェクトに新しいタスクを追加するコードの記述
次に、ThisAddIn コード ファイルにコードを追加します。新しいコードでは、Project のオブジェクト モデルを使用して、プロジェクトに新しいタスクを追加します。ThisAddIn コード ファイルには、次のコードが既定で含まれています。
ThisAddIn クラスの部分定義。このクラスは、コードのエントリ ポイントを提供し、Project のオブジェクト モデルへのアクセスを提供します。詳細については、「アプリケーション レベルのアドインのプログラミング」を参照してください。ThisAddIn クラスの残りの部分は、変更することができない非表示のコード ファイルに定義されています。
ThisAddIn_Startup イベント ハンドラーおよび ThisAddIn_Shutdown イベント ハンドラー。これらのイベント ハンドラーは、Project がアドインを読み込むときとアンロードするときに呼び出されます。これらのイベント ハンドラーを使用して、読み込まれるときにはアドインを初期化し、アンロードされるときにはアドインが使用したリソースをクリーンアップします。詳細については、「Office プロジェクトのイベント」を参照してください。
新しいプロジェクトにタスクを追加するには
ThisAddIn コード ファイルで、次のコードを ThisAddIn クラスに追加します。このコードは、Microsoft.Office.Interop.MSProject.Application クラスの NewProject イベントのイベント ハンドラーを定義します。
ユーザーが新しいプロジェクトを作成すると、このイベント ハンドラーによってプロジェクトに新しいタスクが追加されます。
Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject Dim newTask As MSProject.Task newTask = pj.Tasks.Add _ ("This text was added by using code") newTask.Start = DateTime.Now newTask.Duration = "3" newTask.ResourceNames = "Rob Caron, Kelly Krout" End Sub
void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj) { MSProject.Task newTask = pj.Tasks.Add ("This text was added by using code", missing); newTask.Start = DateTime.Now; newTask.Duration = "3"; newTask.ResourceNames = "Rob Caron, Kelly Krout"; }
プロジェクトを変更するため、このコード例では次のオブジェクトを使用しています。
ThisAddIn クラスの Application フィールド。Application フィールドは Project の現在のインスタンスを表す Microsoft.Office.Interop.MSProject.Application オブジェクトを返します。
NewProject イベントのイベント ハンドラーの pj パラメーター。pj パラメーターは、プロジェクトを表す Microsoft.Office.Interop.MSProject.Project オブジェクトです。詳細については、「Project ソリューション」を参照してください。
C# を使用している場合は、次のコードを ThisAddIn_Startup イベント ハンドラーに追加します。このコードは、Application_Newproject イベント ハンドラーを NewProject イベントに接続します。
this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
プロジェクトのテスト
プロジェクトをビルドして実行し、新しいプロジェクトに新しいタスクが表示されることを確認します。
プロジェクトをテストするには
F5 キーを押して、プロジェクトをビルドおよび実行します。Microsoft Project が起動し、新しい空のプロジェクトが自動的に開きます。
プロジェクトをビルドすると、コードはアセンブリにコンパイルされ、プロジェクトのビルド出力フォルダーに保存されます。さらに Visual Studio は、Project がアドインを検出して読み込むようにする一連のレジストリ エントリを作成し、アドインを実行できるように開発用コンピューター上のセキュリティを設定します。詳細については、「Office Solution Build Process Overview」を参照してください。
新しいタスクがプロジェクトに追加されることを確認します。
次のテキストがタスクの Task Name に表示されることを確認します。
This text was added by using code.
Microsoft Project を閉じます。
プロジェクトのクリーンアップ
プロジェクトの開発を完了したら、アドイン アセンブリ、レジストリ エントリ、およびセキュリティ設定を開発用コンピューターから削除します。この操作を行わないと、開発用コンピューター上で Microsoft Project を起動するたびにアドインが実行されます。
プロジェクトをクリーンアップするには
- Visual Studio で、[ビルド] メニューの [ソリューションのクリーン] をクリックします。
次の手順
Project 用の基本的なアプリケーション レベルのアドインを作成した後は、アドインの作成方法の詳細について、以下のトピックを参照してください。
Project のアドインで実行できる一般的なプログラミング タスク : アプリケーション レベルのアドインのプログラミング
Project のオブジェクト モデル ドキュメントの使用 : Project ソリューション
Project 用のアプリケーション レベルのアドインのビルドとデバッグ : Office ソリューションのビルド
Project 用のアプリケーション レベルのアドインの配置 : Office ソリューションの配置