Procédure pas à pas : création de votre premier complément VSTO pour PowerPointWalkthrough: Creating Your First VSTO Add-in for PowerPoint

Cette procédure pas à pas montre comment créer un complément VSTO pour Microsoft Office PowerPoint.This walkthrough shows you how to create an VSTO Add-in for Microsoft Office PowerPoint. Les fonctionnalités que vous créez dans ce type de solution sont accessibles à l’application, quelles que soient les présentations ouvertes.The features that you create in this kind of solution are available to the application itself, regardless of which presentations are open. Pour plus d’informations, consultez présentation du développement de Solutions Office (VSTO).For more information, see Office Solutions Development Overview (VSTO).

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de compléments VSTO pour PowerPoint.Applies to: The information in this topic applies to VSTO add-in projects for PowerPoint. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features Available by Office Application and Project Type.

Cette procédure pas à pas décrit les tâches suivantes :This walkthrough illustrates the following tasks:

  • création d'un projet de complément PowerPoint VSTO pour PowerPoint ;Creating a PowerPoint VSTO Add-in project for PowerPoint.

  • écriture de code utilisant le modèle objet de PowerPoint pour ajouter une zone de texte à chaque nouvelle diapositive ;Writing code that uses the object model of PowerPoint to add a text box to each new slide.

  • Génération et exécution du projet pour le testerBuilding and running the project to test it.

  • nettoyage du projet pour que le complément VSTO ne s’exécute plus automatiquement sur votre ordinateur de développement.Cleaning up the project so that the VSTO Add-in no longer runs automatically on your development computer.

    Note

    Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L’édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use determine these elements. Pour plus d’informations, consultez personnaliser l’IDE.For more information, see Personalize the IDE.

PrérequisPrerequisites

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :You need the following components to complete this walkthrough:

Création du projetCreating the Project

Pour créer un projetTo create a new project

  1. Démarrez Visual StudioVisual Studio.Start Visual StudioVisual Studio.

  2. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.On the File menu, point to New, and then click Project.

  3. Dans le volet Modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.In the templates pane, expand Visual C# or Visual Basic, and then expand Office/SharePoint.

  4. Sous le nœud développé Office/SharePoint , sélectionnez le nœud Compléments Office .Under the expanded Office/SharePoint node, select the Office Add-ins node.

  5. Dans la liste des modèles de projet, sélectionnez un projet de complément PowerPoint VSTO.In the list of project templates, select a PowerPoint VSTO Add-in project.

  6. Dans le nom , tapez FirstPowerPointAddIn.In the Name box, type FirstPowerPointAddIn.

  7. Cliquez sur OK.Click OK.

    Visual StudioVisual Studio crée le FirstPowerPointAddIn projet et ouvre le ThisAddIn fichier de code dans l’éditeur. creates the FirstPowerPointAddIn project and opens the ThisAddIn code file in the editor.

Écriture du code qui ajoute du texte à chaque nouvelle diapositiveWriting Code that Adds Text to Each New Slide

L'étape suivante consiste à ajouter du code au fichier de code ThisAddIn.Next, add code to the ThisAddIn code file. Le nouveau code utilise le modèle objet de PowerPoint pour ajouter une zone de texte à chaque nouvelle diapositive.The new code uses the object model of PowerPoint to add a text box to each new slide. Par défaut, le fichier de code ThisAddIn contient le code généré suivant :By default, the ThisAddIn code file contains the following generated code:

  • Une définition partielle de la classe ThisAddIn .A partial definition of the ThisAddIn class. Cette classe fournit un point d'entrée pour votre code et offre un accès au modèle objet de PowerPoint.This class provides an entry point for your code and provides access to the object model of PowerPoint. Pour plus d'informations, consultez Programming VSTO Add-Ins. Le reste de la classe ThisAddIn est défini dans un fichier de code masqué que vous ne devez pas modifier.For more information, see Programming VSTO Add-Ins. The remainder of the ThisAddIn class is defined in a hidden code file that you should not modify.

  • Les gestionnaires d'événements ThisAddIn_Startup et ThisAddIn_Shutdown .The ThisAddIn_Startup and ThisAddIn_Shutdown event handlers. Ces gestionnaires d'événements sont appelés quand PowerPoint charge et décharge votre complément VSTO.These event handlers are called when PowerPoint loads and unloads your VSTO Add-in. Utilisez ces gestionnaires d'événements pour initialiser votre complément VSTO quand il est chargé, ainsi que pour nettoyer les ressources utilisées par votre complément VSTO quand il est déchargé.Use these event handlers to initialize your VSTO Add-in when it is loaded, and to clean up resources used by your VSTO Add-in when it is unloaded. Pour plus d'informations, consultez Events in Office Projects.For more information, see Events in Office Projects.

Pour ajouter une zone de texte à chaque nouvelle diapositiveTo add a text box to each new slide

  1. Dans le fichier de code ThisAddIn, ajoutez le code suivant à la classe ThisAddIn .In the ThisAddIn code file, add the following code to the ThisAddIn class. Ce code définit un gestionnaire d'événements pour l'événement <xref:Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide> de l'objet Microsoft.Office.Interop.PowerPoint.Application.This code defines an event handler for the <xref:Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide> event of the Microsoft.Office.Interop.PowerPoint.Application object.

    Quand l'utilisateur ajoute une nouvelle diapositive à la présentation active, ce gestionnaire d'événements ajoute une zone de texte en haut de la nouvelle diapositive, puis ajoute du texte à la zone de texte.When the user adds a new slide to the active presentation, this event handler adds a text box to the top of the new slide, and it adds some text to the text box.

    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.");
    }
    
  2. En C#, ajoutez le code suivant au gestionnaire d'événements ThisAddIn_Startup .If you are using C#, add the following code to the ThisAddIn_Startup event handler. Ce code est indispensable pour connecter le gestionnaire d'événements Application_PresentationNewSlide à l'événement <xref:Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide>.This code is required to connect the Application_PresentationNewSlide event handler with the <xref:Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide> event.

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

    Pour modifier chaque nouvelle diapositive, les exemples de code précédents utilisent les objets suivants :To modify each new slide, the previous code examples use the following objects:

Test du projetTesting the Project

Quand vous générez et exécutez le projet, vérifiez que la zone de texte apparaît dans les nouvelles diapositives que vous ajoutez à une présentation.When you build and run the project, verify that the text box appears in new slides that you add to a presentation.

Pour tester le projetTo test the project

  1. Appuyez sur F5 pour générer et exécuter votre projet.Press F5 to build and run your project.

    Quand vous générez le projet, le code est compilé dans un assembly qui est placé dans le dossier de sortie de la génération du projet.When you build the project, the code is compiled into an assembly that is put in the build output folder for the project. Visual Studio crée également un jeu d’entrées du Registre qui permet à PowerPoint de détecter et de charger le complément VSTO. Par ailleurs, il configure les paramètres de sécurité de l’ordinateur de développement pour permettre au complément VSTO de s’exécuter.Visual Studio also creates a set of registry entries that enable PowerPoint to discover and load the VSTO Add-in, and it configures the security settings on the development computer to enable the VSTO Add-in to run. Pour plus d’informations, consultez génération de Solutions Office.For more information, see Building Office Solutions.

  2. Dans PowerPoint, ajoutez une nouvelle diapositive à la présentation active.In PowerPoint, add a new slide to the active presentation.

  3. Vérifiez que le texte suivant est ajouté à une nouvelle zone de texte en haut de la diapositive.Verify that the following text is added to a new text box at the top of the slide.

    Ce texte a été ajouté via le code.This text was added by using code.

  4. Fermez PowerPoint.Close PowerPoint.

Nettoyage du projetCleaning up the Project

Une fois que vous avez fini de développer un projet, supprimez l'assembly de complément VSTO, les entrées du Registre et les paramètres de sécurité de votre ordinateur de développement.When you finish developing a project, remove the VSTO Add-in assembly, registry entries, and security settings from your development computer. Sinon, le complément VSTO s’exécutera chaque fois que vous ouvrirez PowerPoint sur votre ordinateur.Otherwise, the VSTO Add-in will run every time you open PowerPoint on the development computer.

Pour nettoyer votre projetTo clean up your project

  1. Dans Visual Studio, dans le menu Générer , cliquez sur Nettoyer la solution.In Visual Studio, on the Build menu, click Clean Solution.

Étapes suivantesNext Steps

Une fois que vous avez créé un complément VSTO de base pour PowerPoint, vous pouvez perfectionner votre connaissance du développement des compléments VSTO en consultant les rubriques suivantes :Now that you have created a basic VSTO Add-in for PowerPoint, you can learn more about how to develop VSTO Add-ins from these topics:

Voir aussiSee Also

Programming VSTO Add-Ins Programming VSTO Add-Ins
Solutions PowerPoint PowerPoint Solutions
Personnalisation de l’interface utilisateur Office Office UI Customization
Génération de Solutions Office Building Office Solutions
Déploiement d’une Solution Office Deploying an Office Solution
Vue d’ensemble des modèles de projet OfficeOffice Project Templates Overview