Procédure pas à pas : Insérer du texte dans un document à partir d’un volet actionsWalkthrough: Insert text into a document from an actions pane

Cette procédure pas à pas montre comment créer un volet actions dans un document Microsoft Office Word.This walkthrough demonstrates how to create an actions pane in a Microsoft Office Word document. Le volet actions contient deux contrôles qui collecte des commentaires, puis envoient le texte au document.The actions pane contains two controls that collect input and then send the text to the document.

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

Cette procédure pas à pas décrit les tâches suivantes :This walkthrough illustrates the following tasks:

  • Concevoir une interface à l’aide de contrôles Windows Forms sur un contrôle de volet actions.Design an interface by using Windows Forms controls on an actions pane control.

  • Afficher le volet actions lorsque l’application s’ouvre.Display the actions pane when the application opens.

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.

PrérequisPrerequisites

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :You need the following components to complete this walkthrough:

Créer le projetCreate the project

La première étape consiste à créer un projet de document Word.The first step is to create a Word Document project.

Pour créer un projetTo create a new project

  1. Créer un projet de Document Word portant le nom Mon volet Actions base.Create a Word Document project with the name My Basic Actions Pane. Dans l’Assistant, sélectionnez créer un nouveau document.In the wizard, select Create a new document. Pour plus d'informations, voir Procédure : Créer des projets Office dans Visual Studio.For more information, see How to: Create Office projects in Visual Studio.

    Visual Studio ouvre le nouveau document Word dans le concepteur et ajoute le Mon volet Actions base projet l’Explorateur de solutions.Visual Studio opens the new Word document in the designer and adds the My Basic Actions Pane project to Solution Explorer.

Ajouter du texte et signets au documentAdd text and bookmarks to the document

Le volet actions enverra le texte aux signets dans le document.The actions pane will send text to bookmarks in the document. Pour concevoir le document, tapez du texte pour créer un formulaire de base.To design the document, type some text to create a basic form.

Pour ajouter du texte à votre documentTo add text to your document

  1. Tapez le texte suivant dans votre document Word :Type the following text into your Word document:

    21 mars 2008March 21, 2008

    NameName

    AdresseAddress

    Il s’agit d’un exemple d’un volet actions de base dans Word.This is an example of a basic actions pane in Word.

    Vous pouvez ajouter un Bookmark contrôle à votre document en le faisant glisser à partir de la boîte à outils dans Visual Studio ou en utilisant le signet boîte de dialogue dans Word.You can add a Bookmark control to your document by dragging it from the Toolbox in Visual Studio or by using the Bookmark dialog box in Word.

Pour ajouter un contrôle Bookmark à votre documentTo add a Bookmark control to your document

  1. À partir de la contrôles Word onglet de la boîte à outils, faites glisser un Bookmark contrôle à votre document.From the Word Controls tab of the Toolbox, drag a Bookmark control to your document.

    Le ajouter un contrôle Bookmark boîte de dialogue s’affiche.The Add Bookmark Control dialog box appears.

  2. Sélectionner le mot nom, sans en sélectionnant la marque de paragraphe, puis cliquez sur OK.Select the word Name, without selecting the paragraph mark, and click OK.

    Note

    La marque de paragraphe doit être en dehors du signet.The paragraph mark should be outside of the bookmark. Si les marques de paragraphe ne sont pas visibles dans le document, cliquez sur le outils menu, pointez sur outils Microsoft Office Word puis cliquez sur Options.If paragraph marks are not visible in the document, click the Tools menu, point to Microsoft Office Word Tools and then click Options. Cliquez sur le vue onglet, puis sélectionnez le marques de paragraphe case à cocher dans la mise en forme de marques section de la Options boîte de dialogue.Click the View tab, and select the Paragraph marks check box in the Formatting marks section of the Options dialog box.

  3. Dans le propriétés fenêtre, de modifier le nom propriété de Bookmark1 à showName.In the Properties window, change the Name property of Bookmark1 to showName.

  4. Sélectionner le mot adresse, sans sélectionner la marque de paragraphe.Select the word Address, without selecting the paragraph mark.

  5. Sur le insérer onglet du ruban, dans le liens de groupe, cliquez sur signet.On the Insert tab of the Ribbon, in the Links group, click Bookmark.

  6. Dans le signet boîte de dialogue, tapez showAddress dans le nom du signet , puis cliquez sur ajouter.In the Bookmark dialog box, type showAddress in the Bookmark Name box and click Add.

Ajouter des contrôles au volet actionsAdd controls to the actions pane

Pour concevoir l’interface du volet actions, ajoutez un contrôle de volet actions au projet, puis ajoutez des contrôles Windows Forms au contrôle de volet actions.To design the actions pane interface, add an actions pane control to the project and then add Windows Forms controls to the actions pane control.

Pour ajouter un contrôle de volet actionsTo add an actions pane control

  1. Sélectionnez le Mon volet Actions base projet l’Explorateur de solutions.Select the My Basic Actions Pane project in Solution Explorer.

  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, cliquez sur contrôle de volet Actions, nommez le contrôle InsertTextControl et cliquez sur ajouter.In the Add New Item dialog box, click Actions Pane Control, name the control InsertTextControl, and click Add.

Pour ajouter des contrôles Windows Form au contrôle de volet actionsTo add Windows Form controls to the actions pane control

  1. Si le contrôle de volet actions n’est pas visible dans le concepteur, double-cliquez sur InsertTextControl.If the actions pane control is not visible in the designer, double-click InsertTextControl.

  2. À partir de la contrôles communs onglet de la boîte à outils, faites glisser un étiquette vers le contrôle de volet actions.From the Common Controls tab of the Toolbox, drag a Label control to the actions pane control.

  3. Modifier le texte propriété du contrôle Label pour nom.Change the Text property of the Label control to Name.

  4. Ajouter un zone de texte contrôler au contrôle de volet actions et modifiez les propriétés suivantes.Add a Textbox control to the actions pane control, and change the following properties.

    PropriétéProperty ValueValue
    NameName getNamegetName
    TailleSize 130, 20130, 20
  5. Ajoutez une deuxième étiquette contrôler au contrôle de volet actions et modifier le texte propriété adresse.Add a second Label control to the actions pane control, and change the Text property to Address.

  6. Ajoutez une deuxième zone de texte contrôler au contrôle de volet actions et modifiez les propriétés suivantes.Add a second Textbox control to the actions pane control, and change the following properties.

    PropriétéProperty ValueValue
    NameName getAddressgetAddress
    Accepte le retourAccepts Return TrueTrue
    MultilineMultiline TrueTrue
    TailleSize 130, 40130, 40
  7. Ajouter un bouton contrôler au contrôle de volet actions et modifiez les propriétés suivantes.Add a Button control to the actions pane control, and change the following properties.

    PropriétéProperty ValueValue
    NameName addTextaddText
    TextText InsertInsert

Ajoutez du code pour insérer du texte dans le documentAdd code to insert text into the document

Dans le volet actions, écrivez du code qui insère le texte dans les zones de texte appropriées Bookmark contrôles dans le document.In the actions pane, write code that inserts the text from the text boxes into the appropriate Bookmark controls in the document. Vous pouvez utiliser la Globals classe pour accéder aux contrôles dans le document à partir des contrôles dans le volet actions.You can use the Globals class to access controls on the document from the controls on the actions pane. Pour plus d’informations, consultez d’accès Global aux objets dans les projets Office.For more information, see Global access to objects in Office projects.

Pour insérer du texte dans le volet actions dans un signet dans le documentTo insert text from the actions pane in a bookmark in the document

  1. Ajoutez le code suivant à la Click Gestionnaire d’événements de la addText bouton.Add the following code to the Click event handler of the addText button.

    private void addText_Click(object sender, System.EventArgs e)
    {
        if (this.getName.Text != String.Empty) 
        {
            Globals.ThisDocument.showName.Text = this.getName.Text;
        }
    
        if (this.getAddress.Text != String.Empty)
        {
            Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
        }
    
        this.getName.Text = String.Empty;
        this.getAddress.Text = String.Empty;
    }
    
    Private Sub addText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
        Handles addText.Click
    
        If Me.getName.Text <> String.Empty Then
            Globals.ThisDocument.showName.Text = Me.getName.Text
        End If
    
        If Me.getAddress.Text <> String.Empty Then
            Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
        End If
    
        Me.getName.Text = String.Empty
        Me.getAddress.Text = String.Empty
    End Sub
    
  2. 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 InsertTextControl constructeur après l’appel à InitializeComponent.You can place this code in the InsertTextControl constructor after the call to InitializeComponent. 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 creating event handlers, see How to: Create event handlers in Office projects.

    public InsertTextControl()
    {
        InitializeComponent();
        this.addText.Click += new EventHandler(addText_Click);
    }
    

Ajoutez du code pour afficher le volet actionsAdd code to show the actions pane

Pour afficher le volet actions, ajoutez le contrôle que vous avez créé à la collection de contrôles.To show the actions pane, add the control you created to the control collection.

Pour afficher le volet actionsTo show the actions pane

  1. Créer une nouvelle instance du contrôle de volet actions dans le ThisDocument classe.Create a new instance of the actions pane control in the ThisDocument class.

    private InsertTextControl insertText = new InsertTextControl();
    
    Dim insertText As New InsertTextControl
    
  2. Ajoutez le code suivant à la Startup Gestionnaire d’événements de ThisDocument.Add the following code to the Startup event handler of ThisDocument.

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

Tester l’applicationTest the application

Tester votre document pour vérifier que le volet actions s’ouvre lorsque le document est ouvert et que le texte tapé dans les zones de texte est inséré dans les signets lorsque le bouton est activé.Test your document to verify that the actions pane opens when the document is opened and that text typed into the text boxes is inserted into the bookmarks when the button is clicked.

Pour tester votre documentTo test your document

  1. Appuyez sur F5 pour exécuter votre projet.Press F5 to run your project.

  2. Vérifiez que le volet actions est visible.Confirm that the actions pane is visible.

  3. Tapez votre nom et l’adresse dans les zones de texte dans le volet actions, cliquez sur insérer.Type your name and address into the text boxes on the actions pane and click Insert.

Étapes suivantesNext steps

Voici quelques tâches susceptibles de venir après :Here are some tasks that might come next:

Voir aussiSee also