Procédure pas à pas : Automatiser une application à partir d’un volet Office personnalisé

Cette procédure pas à pas montre comment créer un volet Office personnalisé qui automatise PowerPoint. Le volet Office personnalisé insère des dates dans une diapositive quand l’utilisateur clique sur un contrôle MonthCalendar dans le volet Office personnalisé.

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

Bien que cette procédure pas à pas utilise spécifiquement PowerPoint, les concepts présentés ici s’appliquent aux applications listées ci-dessus.

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

• Conception de l’interface utilisateur du volet Office personnalisé.

• Automatisation de PowerPoint à partir du volet Office personnalisé.

• Affichage du volet Office personnalisé dans PowerPoint.

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 Visual Studio.

Prérequis

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

• Une édition de Visual Studio qui inclut les outils de développement Microsoft Office. Pour plus d’informations, consultez Configurer un ordinateur pour développer des solutions Bureau.

• Microsoft PowerPoint 2010 ou PowerPoint 2013 .

Créer le projet de complément

La première étape consiste à créer un projet de complément VSTO pour PowerPoint.

Pour créer un projet

1. Créez un projet de complément PowerPoint VSTO nommé MyAddIn, en utilisant le modèle de projet de complément PowerPoint. Pour plus d’informations, consultez Guide pratique pour créer des projets Bureau dans Visual Studio.

   Visual Studio ouvre le fichier de code ThisAddIn.cs ou ThisAddIn.vb et ajoute le projet MyAddIn à Explorateur de solutions.

Concevoir l’interface utilisateur du volet Office personnalisé

Il n’existe aucun concepteur visuel pour les volets Office personnalisés. Toutefois, vous pouvez concevoir un contrôle utilisateur avec la disposition de votre choix. À une étape ultérieure de cette procédure, vous ajouterez le contrôle utilisateur au volet des tâches personnalisé.

Pour concevoir l’interface utilisateur du volet Office personnalisé

1. Dans le menu Projet , cliquez sur Ajouter un contrôle utilisateur.

2. Dans la boîte de dialogue Ajouter un nouvel élément , remplacez le nom du contrôle utilisateur par MyUserControl, puis cliquez sur Ajouter.

   Le contrôle utilisateur s'ouvre dans le concepteur.

3. Sous l’onglet Contrôles communs de la Boîte à outils, faites glisser un contrôle MonthCalendar vers le contrôle utilisateur.

   Si le contrôle MonthCalendar est plus grand que l’aire de conception du contrôle utilisateur, redimensionnez le contrôle utilisateur en fonction du contrôle MonthCalendar .

Automatiser PowerPoint à partir du volet Office personnalisé

Le complément VSTO place la date sélectionnée dans la première diapositive de la présentation active. Utilisez l’événement DateChanged du contrôle pour ajouter la date sélectionnée chaque fois qu’elle change.

Pour automatiser PowerPoint à partir du volet Office personnalisé

1. Dans le concepteur, double-cliquez sur le contrôle MonthCalendar .

   Le fichier MyUserControl.cs ou MyUserControl.vb s’ouvre, et un gestionnaire d’événements est créé pour l’événement DateChanged .

2. Ajoutez le code suivant au début du fichier. Ce code crée des alias pour les Microsoft.Office.Core espaces de noms PowerPoint et les espaces de noms.

   C#

   using Office = Microsoft.Office.Core;
   using PowerPoint = Microsoft.Office.Interop.PowerPoint;
   

   VB

   Imports Office = Microsoft.Office.Core
   Imports PowerPoint = Microsoft.Office.Interop.PowerPoint
   

3. Ajoutez le code suivant à la classe MyUserControl . Ce code déclare un objet Shape en tant que membre de MyUserControl. Dans l’étape suivante, vous allez utiliser cette forme pour ajouter une zone de texte à une diapositive de la présentation active.

   C#

   private PowerPoint.Shape textbox;
   

   VB

   Private TextBox As PowerPoint.Shape
   

4. Remplacez le gestionnaire d'événements monthCalendar1_DateChanged par le code suivant. Ce code ajoute une zone de texte à la première diapositive de la présentation active, puis ajoute la date actuellement sélectionnée à la zone de texte. Ce code utilise l’objet Globals.ThisAddIn pour accéder au modèle objet de PowerPoint.

   C#

   private void monthCalendar1_DateChanged(object sender, DateRangeEventArgs e)
   {
       try
       {
           if (textbox != null)
           {
               textbox.Delete();
           }
   
           PowerPoint.Slide slide =
               Globals.ThisAddIn.Application.ActivePresentation.Slides[1];
           textbox = slide.Shapes.AddTextbox(
               Office.MsoTextOrientation.msoTextOrientationHorizontal,
               50, 100, 600, 50);
           textbox.TextFrame.TextRange.Text = e.Start.ToLongDateString();
           textbox.TextFrame.TextRange.Font.Size = 48;
           textbox.TextFrame.TextRange.Font.Color.RGB =
                Color.DarkViolet.ToArgb();
       }
       catch (Exception ex)
       {
           MessageBox.Show(ex.ToString());
       }
   }
   

   VB

   Private Sub MonthCalendar1_DateChanged( _
       ByVal sender As System.Object, _
       ByVal e As System.Windows.Forms.DateRangeEventArgs) _
       Handles MonthCalendar1.DateChanged
   
       Try
           If TextBox IsNot Nothing Then
               TextBox.Delete()
           End If
   
           Dim Slide As PowerPoint.Slide
           Slide = Globals.ThisAddIn.Application.ActivePresentation.Slides(1)
           TextBox = Slide.Shapes.AddTextbox( _
               Office.MsoTextOrientation.msoTextOrientationHorizontal, _
               50, 100, 600, 50)
           TextBox.TextFrame.TextRange.Text = e.Start.ToLongDateString()
           TextBox.TextFrame.TextRange.Font.Size = 48
           TextBox.TextFrame.TextRange.Font.Color.RGB = _
               System.Drawing.Color.DarkViolet.ToArgb()
   
       Catch ex As Exception
           System.Windows.Forms.MessageBox.Show(ex.ToString())
       End Try
   End Sub
   

5. Dans l’ Explorateur de solutions, cliquez avec le bouton droit sur le projet MyAddIn , puis cliquez sur Générer. Vérifiez que le projet se génère sans erreur.

Afficher le volet Office personnalisé

Pour afficher le volet Office personnalisé quand le complément VSTO démarre, ajoutez le contrôle utilisateur au volet Office dans le gestionnaire d’événements Startup du complément VSTO.

Pour afficher le volet Office personnalisé

1. Dans l’ Explorateur de solutions, développez PowerPoint.

2. Cliquez avec le bouton droit sur ThisAddIn.cs ou ThisAddIn.vb , puis cliquez sur Afficher le code.

3. Ajoutez le code suivant à la classe ThisAddIn . Ce code déclare des instances de MyUserControl et CustomTaskPane en tant que membres de la classe ThisAddIn .

   C#

   private MyUserControl myUserControl1;
   private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;
   

   VB

   Private myUserControl1 As MyUserControl
   Private myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane
   

4. Remplacez le gestionnaire d'événements ThisAddIn_Startup par le code suivant. Ce code crée CustomTaskPane en ajoutant l'objet MyUserControl à la collection CustomTaskPanes . Le code affiche également le volet des tâches.

   C#

   private void ThisAddIn_Startup(object sender, System.EventArgs e)
   {
       myUserControl1 = new MyUserControl();
       myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "Calendar");
       myCustomTaskPane.Visible = true;
   }
   

   VB

   Private Sub ThisAddIn_Startup(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles Me.Startup
   
       myUserControl1 = New MyUserControl
       myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "Calendar")
       myCustomTaskPane.Visible = True
   End Sub
   

Tester le complément

Quand vous exécutez le projet, PowerPoint s’ouvre et le complément VSTO affiche le volet Office personnalisé. Cliquez sur le contrôle MonthCalendar pour tester le code.

Pour tester votre complément VSTO

1. Appuyez sur F5 pour exécuter votre projet.

2. Vérifiez que le volet Office personnalisé est visible.

3. Cliquez sur une date du contrôle MonthCalendar dans le volet Office.

   La date est insérée dans la première diapositive de la présentation active.

Étapes suivantes

Pour plus d’informations sur la création de volets Office personnalisés, consultez les rubriques suivantes :

• Créez un volet Office personnalisé dans un complément VSTO pour une autre application. Pour plus d’informations sur les applications qui prennent en charge les volets office personnalisés, consultez volets Office personnalisés.

• Créer un bouton de ruban qui permet de masquer ou d’afficher un volet Office personnalisé. Pour plus d’informations, consultez Procédure pas à pas : Synchroniser un volet Office personnalisé avec un bouton Ruban.

• Créer un volet Office personnalisé pour chaque message électronique ouvert dans Outlook. Pour plus d’informations, consultez Procédure pas à pas : afficher des volets office personnalisés avec des messages électroniques dans Outlook.

Contenu connexe

• Volets Office personnalisés
• Guide pratique pour ajouter un volet Office personnalisé à une application
• Procédure pas à pas : synchroniser un volet Office personnalisé avec un bouton ruban
• Procédure pas à pas : afficher des volets office personnalisés avec des messages électroniques dans Outlook