Créer votre premier complément de contenu PowerPoint
Dans cet article, vous allez parcourir le processus de création d’un complément de contenu PowerPoint à l’aide de Visual Studio.
Créer le complément
Configuration requise
Visual Studio 2019 ou une version ultérieure avec la charge de travail de développement Office/SharePoint installée.
Remarque
Si vous avez déjà installé Visual Studio, utilisez le programme d'installation de Visual Studio pour vous assurer que la charge de travail de développement Office/SharePoint est installée.
Office connecté à un abonnement Microsoft 365 (y compris Office on the web).
Création du projet de complément
Dans Visual Studio, choisissez Créer un nouveau projet.
À l’aide de la zone de recherche, entrez complément. Choisissez Complément web PowerPoint, puis sélectionnez Suivant.
Nommez votre projet et sélectionnez Créer.
Dans la boîte de dialogue Créer un complément Office , choisissez Insérer du contenu dans les diapositives PowerPoint, puis choisissez Terminer pour créer le projet.
Visual Studio crée une solution et ses deux projets apparaissent dans l’Explorateur de solutions. Le fichier Home.html s’ouvre dans Visual Studio.
Explorer la solution Visual Studio
Quand vous arrivez au bout de l’Assistant, Visual Studio crée une solution qui contient deux projets.
Project | Description |
---|---|
Projet de complément | Contient uniquement un fichier manifeste de complément au format XML, qui contient tous les paramètres qui décrivent votre complément. Ces paramètres aident l’application Office à déterminer le moment où votre complément doit être activé et l’emplacement où il doit apparaître. Visual Studio génère le contenu de ce fichier pour vous permettre d’exécuter le projet et d’utiliser votre complément immédiatement. Modifiez ces paramètres à tout moment en modifiant le fichier XML. |
Projet d’application web | Contient les pages de contenu de votre complément, notamment tous les fichiers et références de fichiers dont vous avez besoin pour développer des pages HTML et JavaScript compatibles avec Office. Pendant que vous développez votre complément, Visual Studio héberge l’application web sur votre serveur IIS local. Lorsque vous êtes prêt à publier le complément, vous devez déployer ce projet d’application web sur un serveur web. |
Mise à jour du code
Home.html spécifie le code HTML qui s’affichera dans le volet Office du complément. Dans Home.html, recherchez l’élément
<p>
qui contient le texte « Cet exemple lit la sélection de document active » et l’élément<button>
où estid
« get-data-from-selection ». Remplacez ces éléments entiers par le balisage suivant, puis enregistrez le fichier.<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>
Ouvrez le fichier Home.js à la racine du projet d’application web. Ce fichier spécifie le script pour le complément. Recherchez la
getDataFromSelection
fonction et remplacez la fonction entière par le code suivant, puis enregistrez le fichier.// 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.'); } }
Mise à jour du manifeste
Ouvrez le fichier manifeste du complément uniquement dans le projet de complément. Ce fichier définit les paramètres et les fonctionnalités du complément.
L’élément
ProviderName
possède une valeur d’espace réservé. Remplacez-le par votre nom.L’attribut
DefaultValue
de l’élémentDisplayName
possède un espace réservé. Remplacez-le par My Office Add-in.L’attribut
DefaultValue
de l’élémentDescription
possède un espace réservé. Remplacez-le par un complément de contenu pour PowerPoint.Enregistrez le fichier. Les lignes mises à jour doivent ressembler à l’exemple de code suivant.
... <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."/> ...
Essayez
À l’aide de Visual Studio, testez le complément PowerPoint nouvellement créé en appuyant sur F5 ou en choisissant le bouton Démarrer pour lancer PowerPoint avec le complément de contenu affiché sur la diapositive.
Dans PowerPoint, choisissez le bouton Obtenir les détails de la diapositive dans le complément de contenu pour obtenir des détails sur la diapositive active.
Remarque
Pour voir la sortie console.log
, vous devrez disposer d’un ensemble distinct d’outils de développement dédiés à une console JavaScript. Pour en savoir plus sur les outils F12 et les Outils de développement Microsoft Edge, consultez Déboguer des compléments à l’aide des outils de développement pour Internet Explorer, Déboguer des compléments à l’aide des outils de développement pour Edge Legacy, ou Déboguer les compléments à l’aide des outils de développement dans Microsoft Edge (basé sur Chromium).
Étapes suivantes
Félicitations, vous avez créé un complément de contenu PowerPoint ! Ensuite, en savoir plus sur la création de compléments Office avec Visual Studio.