チュートリアル: 初めての PowerPoint 用 VSTO アドインを作成する

[アーティクル]
06/19/2023

このチュートリアルでは、Microsoft Office PowerPoint 用の VSTO アドインを作成する方法について説明します。この種のソリューションに作成した機能は、どのプレゼンテーションが開いているかにかかわらず、アプリケーション自体に対して使用できます。詳細については、「Office ソリューションの開発の概要 (VSTO)」を参照してください。

対象: このトピックの情報は、PowerPoint の VSTO アドインのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このチュートリアルでは、次の作業について説明します。

PowerPoint の PowerPoint VSTO アドインプロジェクトを作成する。
PowerPoint のオブジェクトモデルを使用して、新しい各スライドにテキストボックスを追加するコードを記述する。
プロジェクトをビルドし、実行してテストする。
プロジェクトをクリーンアップして、開発用コンピューターで VSTO アドインが自動的に実行されないようにする。

Note

次の手順で参照している Visual Studio ユーザーインターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio IDE のカスタマイズ」を参照してください。

必須コンポーネント

このチュートリアルを実行するには、次のコンポーネントが必要です。

Microsoft Office Developer Tools が含まれている Visual Studio のエディション。詳細については、「Office ソリューションを開発できるようにコンピューターを構成する」を参照してください。
PowerPoint

プロジェクトを作成する

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

Visual Studio を起動します。
[ファイル] メニューの [新規作成] をポイントし、 [プロジェクト] をクリックします。
テンプレートペインで、 [Visual C#] または [Visual Basic]を展開してから、 [Office/SharePoint]を展開します。
展開した [Office/SharePoint] ノードの下で、 [Office Add-ins] ノードを選択します。
プロジェクトテンプレートの一覧で、PowerPoint VSTO アドインプロジェクトを選択します。
[名前] ボックスに、「FirstPowerPointAddIn」と入力します。
OK をクリックします。

Visual Studio により FirstPowerPointAddIn プロジェクトが作成され、ThisAddIn コードファイルがエディターで開かれます。

新しい各スライドにテキストを追加するコードを記述する

次に、ThisAddIn コードファイルにコードを追加します。新しいコードは PowerPoint のオブジェクトモデルを使用して、新しい各スライドにテキストボックスを追加します。 ThisAddIn コードファイルには、次の生成コードが既定で含まれています。

ThisAddIn クラスの部分定義。このクラスは、コードのエントリポイントを提供し、PowerPoint のオブジェクトモデルへのアクセスを提供します。詳しくは、「VSTO アドインのプログラミング」をご覧ください。ThisAddIn クラスの残りの部分は、変更することができない非表示のコードファイルに定義されています。
ThisAddIn_Startup および ThisAddIn_Shutdown イベントハンドラー。これらのイベントハンドラーは、PowerPoint が VSTO アドインを読み込むときとアンロードするときに呼び出されます。これらのイベントハンドラーを使用して、VSTO アドインを読み込むときに初期化し、VSTO アドインがアンロードされるときには使用したリソースをクリーンアップします。詳細については、「Office プロジェクトのイベント」を参照してください。

新しい各スライドにテキストボックスを追加するには

ThisAddIn コードファイルで、次のコードを ThisAddIn クラスに追加します。このコードは、Application オブジェクトの Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide イベントのイベントハンドラーを定義します。

ユーザーが、アクティブなプレゼンテーションに新しいスライドを追加するとき、このイベントハンドラーは、新しいスライドの先頭にテキストボックスを追加し、テキストボックスにテキストを追加します。

void Application_PresentationNewSlide(PowerPoint.Slide Sld)
{
    PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
}

Private Sub Application_PresentationNewSlide(ByVal Sld As PowerPoint.Slide) _
    Handles Application.PresentationNewSlide
    Dim textBox As PowerPoint.Shape = Sld.Shapes.AddTextbox( _
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50)
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.")
End Sub

C# を使用する場合は、次のコードを ThisAddIn_Startup イベントハンドラーに追加します。このコードは、Application_PresentationNewSlide イベントハンドラーを Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide イベントに接続するために必要です。
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```
新しい各スライドを変更するために、前のコード例では次のオブジェクトを使用しています。

Application クラスの ThisAddIn フィールド。 Application フィールドは、PowerPoint の現在のインスタンスを表す Application オブジェクトを返します。
Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide イベントのイベントハンドラーの Sld パラメーター。 Sld パラメーターは、新しいスライドを表す Slide オブジェクトです。詳細については、「PowerPoint ソリューション」を参照してください。

プロジェクトをテストする

プロジェクトをビルドして実行するときに、プレゼンテーションに追加した新しいスライドに、テキストボックスが表示されることを確認します。

プロジェクトをテストするには

F5 キーを押して、プロジェクトをビルドおよび実行します。

プロジェクトをビルドすると、プロジェクトのビルド出力フォルダーに置かれるアセンブリにコードがコンパイルされます。さらに Visual Studio は、PowerPoint が VSTO アドインを検出して読み込めるようにする一連のレジストリエントリを作成し、VSTO アドインを実行できるように開発用コンピューター上のセキュリティ設定値を構成します。詳細については、「Office ソリューションのビルド」を参照してください。
PowerPoint で、作業中のプレゼンテーションに新しいスライドを追加します。
次のテキストが、スライド上部の新しいテキストボックスに追加されていることを確認します。

This text was added by using code.
PowerPoint を閉じます。

プロジェクトをクリーンアップする

プロジェクトの開発が完了したら、VSTO アドインアセンブリ、レジストリエントリ、およびセキュリティ設定を開発用コンピューターから削除します。そうしない場合、開発用コンピューターで PowerPoint を起動するたびに VSTO アドインが実行されます。

プロジェクトをクリーンアップするには

Visual Studio で、 [ビルド] メニューの [ソリューションのクリーン]をクリックします。

次のステップ

これで PowerPoint 用の基本的な VSTO アドインが作成されました。VSTO アドインの開発方法の詳細について、以下のトピックを参照してください。

PowerPoint 用 VSTO アドインで実行できる一般的なプログラミングタスク。詳細については、「VSTO アドインのプログラミング」を参照してください。
PowerPoint のオブジェクトモデルの使用詳細については、「PowerPoint ソリューション」を参照してください。
PowerPoint のユーザーインターフェイス (UI) のカスタマイズ (リボンへのカスタムタブの追加や独自のカスタム作業ウィンドウの作成など)。詳細については、「Office UI のカスタマイズ」を参照してください。
PowerPoint 用 VSTO アドインのビルドおよびデバッグ。詳細については、「Office ソリューションのビルド」を参照してください。
PowerPoint 用 VSTO アドインの配置。詳細については、「Office ソリューションを配置する」を参照してください。