Comment : ajouter un volet Actions à des documents Word ou à des classeurs ExcelHow to: Add an Actions Pane to Word Documents or Excel Workbooks

Pour ajouter un volet actions à un document Microsoft Office Word ou un classeur Microsoft Excel, d’abord créer un contrôle utilisateur Windows Forms.To add an actions pane to a Microsoft Office Word document or a Microsoft Excel workbook, first create a Windows Forms user control. Ensuite, ajoutez le contrôle utilisateur à la Controls propriété de la ThisDocument.ActionsPane champ (Word) ou ThisWorkbook.ActionsPane champ (Excel) dans votre projet.Then, add the user control to the Controls property of the ThisDocument.ActionsPane field (Word) or ThisWorkbook.ActionsPane field (Excel) in your project.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document pour Excel et Word.Applies to: The information in this topic applies to document-level projects for Excel and Word. 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.

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 Visual Studio.For more information, see Personalize the Visual Studio IDE.

Création du contrôle utilisateurCreating the User Control

La procédure suivante montre comment créer un mot de contrôle utilisateur ou un projet d’Excel.The following procedure shows how to create user control in a Word or Excel project. Il ajoute également un bouton au contrôle utilisateur qui écrit du texte dans le document ou le classeur lorsqu’il est activé.It also adds a button to the user control that writes text to the document or workbook when it is clicked.

Pour créer le contrôle utilisateurTo create the user control

  1. Ouvrez votre projet au niveau du document Word ou Excel dans Visual Studio.Open your Word or Excel document-level project in Visual Studio.

  2. Dans le menu Projet , cliquez sur Ajouter un nouvel élément.On the Project menu, click Add New Item.

  3. Dans le ajouter un nouvel élément boîte de dialogue, sélectionnez contrôle de volet Actions, nommez-le HelloControl, puis cliquez sur ajouter.In the Add New Item dialog box, select Actions Pane Control, name it HelloControl, and click Add.

    Note

    Vous pouvez également ajouter un contrôle utilisateur élément à votre projet.You can alternatively add a User Control item to your project. Les classes générées par le contrôle de volet Actions et contrôle utilisateur éléments sont fonctionnellement équivalents.The classes generated by the Actions Pane Control and User Control items are functionally equivalent.

  4. À partir de la Windows Forms onglet de la boîte à outils, faites glisser un bouton contrôle sur le contrôle.From the Windows Forms tab of the Toolbox, drag a Button control onto the control.

    Note

    Si le contrôle n’est pas visible dans le concepteur, double-cliquez sur HelloControl dans l’Explorateur de solutions.If the control is not visible in the designer, double click HelloControl in Solution Explorer.

  5. Ajoutez le code à le Click Gestionnaire d’événements du bouton.Add the code to the Click event handler of the button. L’exemple suivant montre le code d’un document Microsoft Office Word.The following example shows code for a Microsoft Office Word document.

    private void button1_Click(object sender, System.EventArgs e)
    {
        Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
    }
    
    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
        Handles Button1.Click
    
        Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
    End Sub
    
  6. En c#, vous devez ajouter un gestionnaire d’événements pour le clic de bouton.In C#, you must add an event handler for the button click. Vous pouvez placer ce code dans le HelloControl constructeur après l’appel à IntializeComponent.You can place this code in the HelloControl constructor after the call to IntializeComponent.

    Pour plus d’informations sur la création de gestionnaires d’événements, consultez Comment : créer des gestionnaires d’événements dans les projets Office.For information about how to create event handlers, see How to: Create Event Handlers in Office Projects.

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

Ajout du contrôle utilisateur au volet ActionsAdding the User Control to the Actions Pane

Pour afficher le volet actions, ajoutez le contrôle utilisateur à la Controls propriété de la ThisDocument.ActionsPane champ (Word) ou ThisWorkbook.ActionsPane champ (Excel).To show the actions pane, add the user control to the Controls property of the ThisDocument.ActionsPane field (Word) or ThisWorkbook.ActionsPane field (Excel).

Pour ajouter le contrôle utilisateur au volet actionsTo add the user control to the actions pane

  1. Ajoutez le code suivant à la ThisDocument ou ThisWorkbook classe comme une déclaration au niveau de la classe (n’ajoutez pas ce code à une méthode).Add the following code to the ThisDocument or ThisWorkbook class as a class-level declaration (do not add this code to a method).

    private HelloControl hello = new HelloControl();
    
    Dim hello As New HelloControl
    
  2. Ajoutez le code suivant à la ThisDocument_Startup Gestionnaire d’événements de la ThisDocument classe ou la ThisWorkbook_Startup Gestionnaire d’événements de la ThisWorkbook classe.Add the following code to the ThisDocument_Startup event handler of the ThisDocument class or the ThisWorkbook_Startup event handler of the ThisWorkbook class.

    this.ActionsPane.Controls.Add(hello);
    
    Me.ActionsPane.Controls.Add(hello)
    

Voir aussiSee Also

Vue d’ensemble du volet Actions Actions Pane Overview
Procédure pas à pas : Insertion de texte dans un Document à partir d’un volet Actions Walkthrough: Inserting Text into a Document from an Actions Pane
Comment : gérer la disposition des contrôles dans les volets Actions How to: Manage Control Layout on Actions Panes
Procédure pas à pas : insertion de texte dans un document à partir d’un volet ActionsWalkthrough: Inserting Text into a Document from an Actions Pane