次の方法で共有


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

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

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

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

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

  • PowerPoint のオブジェクト モデルを使用して、新しい各スライドにテキスト ボックスを追加するコードを記述する。

  • プロジェクトをビルドし、実行してテストする。

  • プロジェクトをクリーンアップして、開発用コンピューターで VSTO アドインが自動的に実行されないようにする。

    Note

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

必須コンポーネント

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

プロジェクトを作成する

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

  1. Visual Studio を起動します。

  2. [ファイル] メニューの [新規作成] をポイントし、 [プロジェクト] をクリックします。

  3. テンプレート ペインで、 [Visual C#] または [Visual Basic]を展開してから、 [Office/SharePoint]を展開します。

  4. 展開した [Office/SharePoint] ノードの下で、 [Office Add-ins] ノードを選択します。

  5. プロジェクト テンプレートの一覧で、PowerPoint VSTO アドイン プロジェクトを選択します。

  6. [名前] ボックスに、「FirstPowerPointAddIn」と入力します。

  7. OK をクリックします。

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

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

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

  • ThisAddIn クラスの部分定義。 このクラスは、コードのエントリ ポイントを提供し、PowerPoint のオブジェクト モデルへのアクセスを提供します。 詳しくは、「VSTO アドインのプログラミング」をご覧ください。ThisAddIn クラスの残りの部分は、変更することができない非表示のコード ファイルに定義されています。

  • ThisAddIn_Startup および ThisAddIn_Shutdown イベント ハンドラー。 これらのイベント ハンドラーは、PowerPoint が VSTO アドインを読み込むときとアンロードするときに呼び出されます。 これらのイベント ハンドラーを使用して、VSTO アドインを読み込むときに初期化し、VSTO アドインがアンロードされるときには使用したリソースをクリーンアップします。 詳細については、「Office プロジェクトのイベント」を参照してください。

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

  1. 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.");
    }
    
  2. C# を使用する場合は、次のコードを ThisAddIn_Startup イベント ハンドラーに追加します。 このコードは、Application_PresentationNewSlide イベント ハンドラーを Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide イベントに接続するために必要です。

    this.Application.PresentationNewSlide += 
        new PowerPoint.EApplication_PresentationNewSlideEventHandler(
        Application_PresentationNewSlide);
    

    新しい各スライドを変更するために、前のコード例では次のオブジェクトを使用しています。

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

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

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

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

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

  2. PowerPoint で、作業中のプレゼンテーションに新しいスライドを追加します。

  3. 次のテキストが、スライド上部の新しいテキスト ボックスに追加されていることを確認します。

    This text was added by using code.

  4. PowerPoint を閉じます。

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

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

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

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

次のステップ

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

  • PowerPoint 用 VSTO アドインで実行できる一般的なプログラミング タスク。 詳細については、「VSTO アドインのプログラミング」を参照してください。

  • PowerPoint のオブジェクト モデルの使用 詳細については、「PowerPoint ソリューション」を参照してください。

  • PowerPoint のユーザー インターフェイス (UI) のカスタマイズ (リボンへのカスタム タブの追加や独自のカスタム作業ウィンドウの作成など)。 詳細については、「Office UI のカスタマイズ」を参照してください。

  • PowerPoint 用 VSTO アドインのビルドおよびデバッグ。 詳細については、「Office ソリューションのビルド」を参照してください。

  • PowerPoint 用 VSTO アドインの配置。 詳細については、「Office ソリューションを配置する」を参照してください。