Procédure pas à pas : Créer votre premier complément VSTO pour PowerPoint

  • Article

Cette procédure pas à pas vous montre comment créer un complément VSTO pour Microsoft Bureau PowerPoint. Les fonctionnalités que vous créez dans ce type de solution sont accessibles à l'application, quelles que soient les présentations ouvertes. Pour plus d’informations, consultez Bureau vue d’ensemble du développement de solutions (VSTO).

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets de complément VSTO pour PowerPoint. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Cette procédure pas à pas décrit les tâches suivantes :

  • création d'un projet de complément PowerPoint VSTO pour PowerPoint ;

  • écriture de code utilisant le modèle objet de PowerPoint pour ajouter une zone de texte à chaque nouvelle diapositive ;

  • Génération et exécution du projet pour le tester

  • nettoyage du projet pour que le complément VSTO ne s'exécute plus automatiquement sur votre ordinateur de développement.

    Remarque

    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. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE.

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

Créer le projet

Pour créer un projet

  1. Démarrez Visual Studio.

  2. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.

  3. Dans le volet Modèles, développez Visual C# ou Visual Basic, puis développez Office/SharePoint.

  4. Sous le nœud développé Office/SharePoint , sélectionnez le nœud Compléments Office .

  5. Dans la liste des modèles de projet, sélectionnez un projet de complément PowerPoint VSTO.

  6. Dans la zone Nom , tapez FirstPowerPointAddIn.

  7. Cliquez sur OK.

    Visual Studio crée le projet FirstPowerPointAddIn et ouvre le fichier de code ThisAddIn dans l’éditeur.

Écrire du code qui ajoute du texte à chaque nouvelle diapositive

L'étape suivante consiste à ajouter du code au fichier de code ThisAddIn. Le nouveau code utilise le modèle objet de PowerPoint pour ajouter une zone de texte à chaque nouvelle diapositive. Par défaut, le fichier de code ThisAddIn contient le code généré suivant :

  • Une définition partielle de la classe ThisAddIn . Cette classe fournit un point d'entrée pour votre code et offre un accès au modèle objet de PowerPoint. Pour plus d’informations, consultez Les compléments VSTO program. Le reste de la ThisAddIn classe est défini dans un fichier de code masqué que vous ne devez pas modifier.

  • Les gestionnaires d'événements ThisAddIn_Startup et ThisAddIn_Shutdown . Ces gestionnaires d’événements sont appelés quand PowerPoint charge et décharge votre complément VSTO. 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é. Pour plus d’informations, consultez Événements dans Bureau projets.

Pour ajouter une zone de texte à chaque nouvelle diapositive

  1. Dans le fichier de code ThisAddIn, ajoutez le code suivant à la classe ThisAddIn . Ce code définit un gestionnaire d’événements pour Microsoft.Bureau. Interop.PowerPoint.EApplication_Event.PresentationNewSlide événement de l’objet Application.

    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.

    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 . Ce code est nécessaire pour connecter le Application_PresentationNewSlide gestionnaire d’événements à Microsoft.Bureau. événement Interop.PowerPoint.EApplication_Event.PresentationNewSlide.

    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 :

Tester le projet

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.

Pour tester le projet

  1. Appuyez sur F5 pour générer et exécuter votre projet.

    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. 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. Pour plus d’informations, consultez Générer des solutions Bureau.

  2. Dans PowerPoint, ajoutez une nouvelle diapositive à la présentation active.

  3. Vérifiez que le texte suivant est ajouté à une nouvelle zone de texte en haut de la diapositive.

    Ce texte a été ajouté via le code.

  4. Fermez PowerPoint.

Nettoyer le projet

Une fois que vous avez terminé de développer un projet, supprimez l'assembly du complément VSTO, les entrées de Registre et les paramètres de sécurité de votre ordinateur de développement. Sinon, le complément VSTO s’exécutera chaque fois que vous ouvrirez PowerPoint sur votre ordinateur.

Pour nettoyer votre projet

  1. Dans Visual Studio, dans le menu Générer , cliquez sur Nettoyer la solution.

Étapes suivantes

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 :

  • Tâches de programmation générales que vous pouvez effectuer dans les compléments VSTO pour PowerPoint. Pour plus d’informations, consultez Les compléments VSTO program.

  • Utilisation du modèle objet de PowerPoint. Pour plus d’informations, consultez les solutions PowerPoint.

  • Personnalisation de l'interface utilisateur de PowerPoint en ajoutant un onglet personnalisé au ruban, ou en créant votre propre volet des tâches personnalisé. Pour plus d’informations, consultez Bureau Personnalisation de l’interface utilisateur.

  • Génération et débogage des compléments VSTO pour PowerPoint. Pour plus d’informations, consultez Générer des solutions Bureau.

  • Déploiement des compléments VSTO pour PowerPoint. Pour plus d’informations, consultez Déployer une solution Bureau.

Contenu connexe