Erstellen Ihres ersten PowerPoint-Inhalts-Add-Ins

In diesem Artikel erfahren Sie, wie Sie mithilfe von Visual Studio ein PowerPoint-Inhalts-Add-In erstellen.

Voraussetzungen

• Visual Studio 2019 oder höher mit installierter Office/SharePoint-Entwicklungsumgebung.

  Hinweis

  Wenn Sie Visual Studio bereits installiert haben, verwenden Sie das Visual Studio-Installationsprogramm, um sicherzustellen, dass die Office/SharePoint-Entwicklungsumgebung installiert ist.

• Office in Verbindung mit einem Microsoft 365-Abonnement (einschließlich Office im Internet).

Erstellen des Add-In-Projekts

1. Wählen Sie in Visual Studio Neues Projekt erstellen.

2. Geben Sie Add-In in das Suchfeld ein. Wählen Sie PowerPoint-Web-Add-In und dann Weiter aus.

3. Benennen Sie Ihr Projekt und wählen Sie Erstellen aus.

4. Wählen Sie im Dialogfeld Office-Add-In erstellen die Option Inhalt in PowerPoint-Folien einfügen und dann Fertig stellen aus, um das Projekt zu erstellen.

5. Visual Studio erstellt eine Projektmappe, und die beiden Projekte werden im Projektmappen-Explorer angezeigt. Die Datei Home.html wird in Visual Studio geöffnet.

Erkunden der Visual Studio-Projektmappe

Wenn Sie den Assistenten abgeschlossen haben, erstellt Visual Studio eine Projektmappe, die zwei Projekte enthält.

Aktualisieren des Codes

1. Home.html gibt den HTML-Code an, der im Add-In-Aufgabenbereich gerendert wird. Suchen Sie inHome.htmlnach dem <p> Element, das den Text "This example will read the current document selection." enthält, und nach dem <button> Element, bei dem " id get-data-from-selection" ist. Ersetzen Sie diese gesamten Elemente durch das folgende Markup, und speichern Sie dann die Datei.

   <p class="ms-font-m-plus">This example will get some details about the current slide.</p>
   
   <button class="Button Button--primary" id="get-data-from-selection">
       <span class="Button-icon"><i class="ms-Icon ms-Icon--plus"></i></span>
       <span class="Button-label">Get slide details</span>
       <span class="Button-description">Gets and displays the current slide's details.</span>
   </button>
   

2. Öffnen Sie die Datei Home.js im Stammordner des Webanwendungsprojekts. Diese Datei gibt das Skript für das Add-In an. Suchen Sie die getDataFromSelection Funktion, und ersetzen Sie die gesamte Funktion durch den folgenden Code, und speichern Sie dann die Datei.

   // Gets some details about the current slide and displays them in 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('Some 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.');
       }
   }
   

Aktualisieren des Manifests

1. Öffnen Sie die Reine Add-In-Manifestdatei im Add-In-Projekt. Diese Datei legt die Einstellungen und Funktionen des Add-Ins fest.

2. Das ProviderName-Element weist einen Platzhalterwert auf. Ersetzen Sie dieses nur Ihren Namen.

3. Das DefaultValue-Attribut des DisplayName-Elements weist einen Platzhalter auf. Ersetzen Sie ihn durch Mein Office-Add-In.

4. Das DefaultValue-Attribut des Description-Elements weist einen Platzhalter auf. Ersetzen Sie es durch ein Inhalts-Add-In für PowerPoint.

5. Speichern Sie die Datei. Die aktualisierten Zeilen sollten wie im folgenden Codebeispiel aussehen.

   ...
   <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."/>
   ...
   

Probieren Sie es aus

1. Testen Sie mithilfe von Visual Studio das neu erstellte PowerPoint-Add-In, indem Sie F5 drücken oder die Schaltfläche Start auswählen, um PowerPoint mit dem Inhalts-Add-In zu starten, das über der Folie angezeigt wird.

2. Wählen Sie in PowerPoint die Schaltfläche Foliendetails abrufen im Inhalts-Add-In aus, um Details zur aktuellen Folie abzurufen.

   

Nächste Schritte

Herzlichen Glückwunsch, Sie haben erfolgreich ein PowerPoint-Inhalts-Add-In erstellt! Als Nächstes, weitere Informationen zum Entwickeln eines Office-Add-Ins mit Visual Studio.

Problembehandlung

• Stellen Sie sicher, dass Ihre Umgebung für die Office-Entwicklung bereit ist, indem Sie die Anweisungen unter Einrichten Ihrer Entwicklungsumgebung befolgen.

• Wenn ihr Add-In einen Fehler anzeigt (z. B. "Dieses Add-In konnte nicht gestartet werden. Schließen Sie dieses Dialogfeld, um das Problem zu ignorieren, oder klicken Sie auf "Neu starten", um es erneut zu versuchen.) Wenn Sie F5 drücken oder Debuggen>starten in Visual Studio auswählen, finden Sie weitere Debugoptionen unter Debuggen von Office-Add-Ins in Visual Studio .

Siehe auch

• Office-Add-Ins-Plattformübersicht
• Entwickeln von Office-Add-Ins
• Visual Studio Code zum Veröffentlichen verwenden