Partager via


Procédure pas à pas : création de votre premier complément d'application pour PowerPoint

Mise à jour : Juillet 2008

S'applique à

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

  • Projets au niveau de l'application

Version de Microsoft Office

  • PowerPoint 2007

  • PowerPoint 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Cette procédure pas à pas vous indique comment créer un complément d'application pour Microsoft Office PowerPoint. Les fonctionnalités que vous créez dans ce type de solution sont disponibles pour l'application même, quelles que soient les présentations ouvertes. Pour plus d'informations, consultez Vue d'ensemble du développement des solutions Office.

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

  • Création d'un projet de complément PowerPoint pour PowerPoint 2003 ou PowerPoint 2007.

  • Écriture de code qui utilise 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 afin que le complément ne s'exécute plus automatiquement sur votre ordinateur de développement.

Remarque :

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio 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 Paramètres Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez :

  • Visual Studio Tools pour Office (composant facultatif de Visual Studio 2008 Professional et Visual Studio Team System).

  • PowerPoint 2003 ou PowerPoint 2007.

Par défaut, Visual Studio Tools pour Office est installé avec les versions répertoriées de Visual Studio. Pour vérifier s'il est installé sur votre ordinateur, consultez Installation de Visual Studio Tools pour Office.

Création du 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 Types de projets, développez Visual C# ou Visual Basic, puis Office.

  4. Sélectionnez le dossier 2007 si vous développez un complément pour PowerPoint 2007, ou sélectionnez le dossier 2003 si vous développez un complément pour PowerPoint 2003.

  5. Dans le volet Modèles, sélectionnez Complément PowerPoint 2007 ou Complément PowerPoint 2003.

  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.

Écriture de code qui ajoute du texte à chaque nouvelle diapositive

L'étape suivante consiste à ajouter du code dans le 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 Élément hôte AddIn. Le reste de la classe ThisAddIn 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 lorsque PowerPoint charge et décharge votre complément. Utilisez ces gestionnaires d'événements pour initialiser votre complément lorsqu'il est chargé et pour nettoyer les ressources utilisées par votre complément lorsqu'il est déchargé. Pour plus d'informations, consultez Événements de projet Visual Studio Tools pour Office.

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 l'événement PresentationNewSlide de la classe Microsoft.Office.Interop.PowerPoint.Application.

    Lorsque 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 il ajoute du texte à la zone de texte.

    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. Si vous utilisez C#, ajoutez le code suivant au gestionnaire d'événements ThisAddIn_Startup. Ce code est requis pour connecter le gestionnaire d'événements Application_PresentationNewSlide à l'événement 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 :

  • Le champ Application de la classe ThisAddIn. Le champ Application retourne un objet Microsoft.Office.Interop.PowerPoint.Application, qui représente l'instance actuelle de PowerPoint.

  • Le paramètre Sld du gestionnaire d'événements pour l'événement PresentationNewSlide. Le paramètre Sld est un objet Microsoft.Office.Interop.PowerPoint.Slide, qui représente la nouvelle diapositive. Pour plus d'informations, consultez Solutions PowerPoint.

Test du projet

Lorsque 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.

    Lorsque vous générez le projet, le code est compilé dans un assembly qui est placé dans le dossier de sortie correspondant. Visual Studio crée également un jeu d'entrées du Registre qui permet à PowerPoint de détecter et de charger le complément. En outre, il configure les paramètres de sécurité de l'ordinateur de développement pour permettre au complément de s'exécuter. Pour plus d'informations, consultez Vue d'ensemble du processus de génération de solutions Office.

  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é en utilisant du code.

  4. Fermez PowerPoint.

Nettoyage du projet

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

Pour nettoyer votre projet

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

Étapes suivantes

Maintenant que vous avez créé un complément d'application de base pour PowerPoint, vous pouvez perfectionner votre connaissance du développement de compléments en consultant ces rubriques :

Voir aussi

Concepts

Programmation de compléments d'application

Solutions PowerPoint

Personnalisation de l'interface utilisateur Office

Vue d'ensemble des modèles de projet Visual Studio Tools pour Office

Référence

Modèles de projet de complément Microsoft Office 2003

Modèles de projet de complément Microsoft Office 2007

Autres ressources

Génération et débogage de solutions Office

Déploiement de solutions Office

Historique des modifications

Date

Historique

Raison

Juillet 2008

Ajout d'une rubrique.

Améliorations apportées aux informations.