初めてのPowerPoint コンテンツ アドインを構築する

この記事では、Visual Studio を使用してPowerPoint コンテンツ アドイン を構築するプロセスについて説明します。

アドインを作成する

前提条件

• Office/SharePoint 開発ワークロードがインストールされた Visual Studio 2019 以降。

  注:

  既に Visual Studio がインストールされている場合は、Visual Studio インストーラーを使用して、Office/SharePoint 開発ワークロードがインストールされていることを確認してください。

• Microsoft 365 サブスクリプションに接続されている Office (Office for the web を含む)。

アドイン プロジェクトの作成

1. Visual Studio で、[新しいプロジェクトの作成] を選択します。

2. 検索ボックスを使用して、アドインと入力します。 [PowerPoint Web アドイン] を選択し、[次へ] を選択します。

3. プロジェクトに名前を付けて、[作成] を選択します。

4. [ Office アドインの作成 ] ダイアログ ウィンドウで、[ PowerPointスライドにコンテンツを挿入する] を選択し、[完了] を選択してプロジェクトを作成 します 。

5. ソリューションが Visual Studio によって作成され、2 つのプロジェクトがソリューション エクスプローラーに表示されます。 Home.html ファイルが Visual Studio で開きます。

Visual Studio ソリューションについて理解する

ウィザードの完了後、Visual Studio によって 2 つのプロジェクトを含むソリューションが作成されます。

コードを更新する

1. Home.html では、アドインの作業ウィンドウにレンダリングされる HTML を指定します。 Home.htmlで、"この例では現在のドキュメントの選択範囲を読み取ります" というテキストを含む <p> 要素を見つけ、要素全体を次のマークアップに置き換えてファイルを保存します。

   <p class="ms-font-m-plus">This example will get details about the current slide.</p>
   

2. Web アプリケーション プロジェクトのルートにあるファイル Home.js を開きます。 このファイルは、アドイン用のスクリプトを指定します。 getDataFromSelection関数を見つけて、関数全体を次のコードに置き換えてから、ファイルを保存します。

   // Reads data from current slide and displays a notification.
   function getDataFromSelection() {
       if (Office.context.document.getSelectedDataAsync) {
           Office.context.document.getSelectedDataAsync(Office.CoercionType.SlideRange,
               function (result) {
                   if (result.status === Office.AsyncResultStatus.Succeeded) {
                       showNotification('The slide details are:', '"' + JSON.stringify(result.value) + '"');
                   } else {
                       showNotification('Error:', result.error.message);
                   }
               }
           );
       } else {
           app.showNotification('Error:', 'Reading selection data is not supported by this host application.');
       }
   }
   

マニフェストを更新する

1. アドイン プロジェクト内の XML マニフェスト ファイルを開きます。 このファイルは、アドインの設定と機能を定義します。

2. ProviderName 要素にはプレースホルダー値が含まれています。 それを自分の名前に置き換えます。

3. DisplayName 要素の DefaultValue 属性にはプレースホルダー値が含まれています。 これは、My Office Add-in に置き換えてください。

4. Description 要素の DefaultValue 属性にはプレースホルダー値が含まれています。 PowerPoint 用のコンテンツ アドインに置き換えます。

5. ファイルを保存します。 更新された行は、次のコード サンプルのようになります。

   ...
   <ProviderName>John Doe</ProviderName>
   <DefaultLocale>en-US</DefaultLocale>
   <!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
   <DisplayName DefaultValue="My Office Add-in" />
   <Description DefaultValue="A content add-in for PowerPoint."/>
   ...
   

試してみる

1. Visual Studio を使用して、新しく作成したPowerPoint アドインをテストするには、 F5 キーを押すか 、[スタート ] ボタンを選択して、スライド上にコンテンツ アドインが表示された状態でPowerPointを起動します。

2. PowerPointで、コンテンツ アドインの [選択からデータを取得 する] ボタンを選択して、現在のスライドの詳細を取得します。

   

次の手順

これで、PowerPoint コンテンツ アドインが正常に作成されました。 次に、「Visual Studio を使用して Office アドインを開発する」を参照してください。

関連項目

• Office アドイン プラットフォームの概要
• Office アドインを開発する
• Visual Studio コードを使用して発行する