Ajouter un volet Actions à des documents Word ou à des classeurs Excel

Pour ajouter un volet Actions à un document Microsoft Bureau Word ou un classeur Microsoft Excel, commencez par créer un contrôle utilisateur Windows Forms. Ensuite, ajoutez le contrôle utilisateur à la ControlsThisDocument.ActionsPane propriété du champ (Word) ou ThisWorkbook.ActionsPane du champ (Excel) dans votre projet.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document pour Excel et Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

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.

Création du contrôle utilisateur

La procédure suivante montre comment créer un contrôle utilisateur dans un projet Word ou Excel. Il ajoute également un bouton au contrôle utilisateur qui écrit du texte dans le document ou le classeur lorsqu’il est cliqué.

Pour créer le contrôle utilisateur

  1. Ouvrez votre projet au niveau du document Word ou Excel dans Visual Studio.

  2. Dans le menu Projet , cliquez sur Ajouter un nouvel élément.

  3. Dans la boîte de dialogue Ajouter un nouvel élément , sélectionnez Contrôle du volet Actions, nommez-le HelloControl, puis cliquez sur Ajouter.

    Remarque

    Vous pouvez également ajouter un élément de contrôle utilisateur à votre projet. Les classes générées par les éléments Contrôle du volet Actions et Contrôle utilisateur sont fonctionnellement équivalentes.

  4. Sous l’onglet Windows Forms de la boîte à outils, faites glisser un contrôle Bouton sur le contrôle.

    Remarque

    Si le contrôle n’est pas visible dans le concepteur, double-cliquez sur HelloControl dans Explorateur de solutions.

  5. Ajoutez le code au Click gestionnaire d’événements du bouton. L’exemple suivant montre le code d’un document Microsoft Bureau Word.

    private void button1_Click(object sender, System.EventArgs e)
    {
        Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
    }
    
  6. En C#, vous devez ajouter un gestionnaire d’événements pour le clic sur le bouton. Vous pouvez placer ce code dans le HelloControl constructeur après l’appel à InitializeComponent.

    Pour plus d’informations sur la création de gestionnaires d’événements, consultez How to : Create Event Handlers in Bureau Projects.

    public HelloControl()
    {
        InitializeComponent();
        this.button1.Click += new EventHandler(this.button1_Click);
    }
    

Ajouter le contrôle utilisateur au volet Actions

Pour afficher le volet Actions, ajoutez le contrôle utilisateur à la Controls propriété du ThisDocument.ActionsPane champ (Word) ou ThisWorkbook.ActionsPane du champ (Excel).

Pour ajouter le contrôle utilisateur au volet Actions

  1. Ajoutez le code suivant à la ou ThisWorkbook à la classe en tant que déclaration au niveau de la ThisDocument classe (n’ajoutez pas ce code à une méthode).

    private HelloControl hello = new HelloControl();
    
  2. Ajoutez le code suivant au ThisDocument_Startup gestionnaire d’événements de la ThisDocument classe ou au ThisWorkbook_Startup gestionnaire d’événements de la ThisWorkbook classe.

    this.ActionsPane.Controls.Add(hello);