チュートリアル : 初めての PowerPoint 用アプリケーションレベルのアドインの作成

[アーティクル]
04/28/2010

更新 : 2008 年 7 月

対象
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。プロジェクトの種類アプリケーションレベルのプロジェクト Microsoft Office のバージョン PowerPoint 2007 PowerPoint 2003 詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。

プロジェクトの種類

アプリケーションレベルのプロジェクト

Microsoft Office のバージョン

PowerPoint 2007
PowerPoint 2003

詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

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

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

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

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

前提条件

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

Visual Studio Tools for Office (Visual Studio 2008 Professional および Visual Studio Team System のオプションの要素)
PowerPoint 2003 または PowerPoint 2007

ここに挙げた Visual Studio のバージョンでは、Visual Studio Tools for Office が既定でインストールされます。お使いのコンピュータにこれがインストールされているかどうかを確認するには、「Visual Studio Tools for Office のインストール」を参照してください。

プロジェクトの作成

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

Visual Studio を起動します。
[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[プロジェクトの種類] ペインで、[Visual C#] または [Visual Basic] を展開し、[Office] を展開します。
[2007] フォルダ (PowerPoint 2007 アドインを開発する場合) または [2003] フォルダ (PowerPoint 2003 アドインを開発する場合) を選択します。
[テンプレート] ペインで、[PowerPoint 2007 アドイン] または [PowerPoint 2003 アドイン] を選択します。
[プロジェクト名] ボックスに「FirstPowerPointAddIn」と入力します。
[OK] をクリックします。

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

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

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

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

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

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

ユーザーがアクティブなプレゼンテーションに新しいスライドを追加すると、このイベントにより、新しいスライドの上部にテキストボックスが追加され、テキストボックスにいくつかのテキストが追加されます。

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

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.");
}

C# を使用している場合は、次のコードを ThisAddIn_Startup イベントハンドラに追加します。このコードは、Application_PresentationNewSlide イベントハンドラを PresentationNewSlide イベントに接続するために必要です。
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```

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

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

プロジェクトのテスト

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

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

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

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

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

プロジェクトのクリーンアップ

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

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

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

次の手順

PowerPoint 用の基本的なアプリケーションレベルのアドインを作成した後は、アドインの作成方法の詳細について、以下のトピックを参照してください。

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

参照

履歴の変更

日付	履歴	理由
2008 年 7 月	トピックを追加	情報の拡充

次の方法で共有

チュートリアル : 初めての PowerPoint 用アプリケーションレベルのアドインの作成

前提条件

プロジェクトの作成

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

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

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

プロジェクトのテスト

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

プロジェクトのクリーンアップ

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

次の手順

参照

概念

参照

その他の技術情報

履歴の変更

その他のリソース

次の方法で共有

チュートリアル : 初めての PowerPoint 用アプリケーション レベルのアドインの作成

前提条件

プロジェクトの作成

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

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

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

プロジェクトのテスト

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

プロジェクトのクリーンアップ

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

次の手順

参照

概念

参照

その他の技術情報

履歴の変更

その他のリソース

チュートリアル : 初めての PowerPoint 用アプリケーションレベルのアドインの作成

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