Procédure pas à pas : Insertion de texte dans un document à partir d'un volet Actions

Cette procédure pas à pas montre la création d'un volet Actions dans un document Microsoft Office Word. Le volet Actions contient deux contrôles qui recueillent l'entrée puis envoient le texte au document.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour Word 2007 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

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

• Conception d'une interface en utilisant des contrôles Windows Forms sur un contrôle de volet Actions.

• Affichage du volet Actions lors de l'ouverture de l'application.

Notes

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. Ces éléments dépendent de l'édition de Visual Studio dont vous disposez et des paramètres que vous utilisez. Pour plus d'informations, consultez Utilisation des paramètres.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer des composants suivants :

-

Une édition de Visual Studio 2010 qui inclut les outils de développement Microsoft Office. Pour plus d'informations, consultez [Configuration d'un ordinateur pour développer des solutions Office](bb398242\(v=vs.100\).md).

• Word 2007 ou Word 2010.

Création du projet

La première étape consiste à créer un projet de document Word.

Pour créer un projet

• Créez un projet de document Word et attribuez-lui le nom My Basic Actions Pane. Dans l'Assistant, sélectionnez Créer un nouveau document. Pour plus d'informations, consultez Comment : créer des projets Office dans Visual Studio.

  Visual Studio ouvre le nouveau document Word dans le concepteur et ajoute le projet My Basic Actions Pane à l'Explorateur de solutions.

Ajout de texte et de signets au document

Le volet Actions enverra le texte aux signets dans le document. Pour concevoir le document, tapez du texte pour créer un formulaire de base.

Pour ajouter du texte à votre document

• Tapez le texte suivant dans votre document Word :

  March 21, 2008

  Nom

  Adresse

  Il s'agit d'un exemple de volet Actions de base dans Word.

Vous pouvez ajouter un contrôle Bookmark dans votre document en le faisant glisser à partir de la Boîte à outils dans Visual Studio ou en utilisant la boîte de dialogue Signet dans Word.

Pour ajouter un contrôle Bookmark à votre document

1. À partir de l'onglet Contrôles Word de la Boîte à outils, faites glisser un contrôle Bookmark vers votre document.

   La boîte de dialogue Ajouter un contrôle Bookmark s'affiche.

2. Sélectionnez le mot Name, sans sélectionner la marque de paragraphe, et cliquez sur OK.

   Notes

   La marque de paragraphe doit être en dehors du signet. Si les marques de paragraphe ne sont pas visibles dans le document, cliquez sur le menu Outils, pointez sur Outils Microsoft Office Word, puis cliquez sur Options. Cliquez sur l'onglet Affichage et activez la case à cocher Marques de paragraphe dans la section Marques de format de la boîte de dialogue Options.

3. Dans la fenêtre Propriétés, remplacez la propriété Name de Bookmark1 par showName.

4. Sélectionnez le mot Address, sans sélectionner la marque de paragraphe.

5. Sous l'onglet Insérer du ruban, dans le groupe Liens, cliquez sur Signet.

6. Dans la boîte de dialogue Signet, tapez showAddress dans la zone Nom du signet et cliquez sur Ajouter.

Ajout de contrôles au volet Actions

Pour concevoir l'interface du volet Actions, ajoutez un contrôle de volet Actions au projet, puis ajoutez les contrôles Windows Forms au contrôle de volet Actions.

Pour ajouter un contrôle de volet Actions

1. Sélectionnez le projet My Basic Actions Pane dans l'Explorateur de solutions.

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

3. Dans la boîte de dialogue Ajouter un nouvel élément, cliquez sur Contrôle de volet Actions, nommez le contrôle InsertTextControl et cliquez sur Ajouter.

Pour ajouter des contrôles Windows Form au contrôle de volet Actions

1. Si le contrôle de volet Actions n'est pas visible dans le concepteur, double-cliquez sur InsertTextControl.

2. À partir de l'onglet Contrôles communs de la Boîte à outils, faites glisser un contrôle Label vers le contrôle de volet Actions.

3. Remplacez la propriété Text du contrôle Label par Name.

4. Ajoutez un contrôle Textbox au contrôle de volet Actions et modifiez les propriétés suivantes.

   Propriété	Valeur
   Nom	getName
   Taille	130, 20

5. Ajoutez un deuxième contrôle Label au contrôle de volet Actions et remplacez la propriété Text par Address.

6. Ajoutez un deuxième contrôle Textbox au contrôle de volet Actions et modifiez les propriétés suivantes.

   Propriété	Valeur
   Nom	getAddress
   Accepts Return	True
   Multiline	True
   Taille	130, 40

7. Ajoutez un contrôle Button au contrôle de volet Actions et modifiez les propriétés suivantes.

   Propriété	Valeur
   Nom	addText
   Texte	Insert

Ajout de code pour insérer du texte dans le document

Dans le volet Actions, écrivez un code qui insère le texte des zones de texte dans les contrôles Bookmark appropriés dans le document. Vous pouvez utiliser la classe Globals pour accéder aux contrôles du document à partir des contrôles du volet Actions. Pour plus d'informations, consultez Accès global aux objets dans les projets Office.

Pour insérer le texte du volet Actions dans un signet dans le document

1. Ajoutez le code suivant au gestionnaire d'événements Click du bouton addText.

   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
   

   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;
   }
   

2. En C#, vous devez ajouter un gestionnaire d'événements pour le clic de bouton. Vous pouvez placer ce code dans le constructeur InsertTextControl, après l'appel à 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.

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

Ajout de code pour afficher le volet Actions

Pour afficher le volet Actions, ajoutez le contrôle créé à la collection de contrôles.

Pour afficher le volet Actions

1. Créez une instance du contrôle de volet Actions dans la classe ThisDocument.

   Dim insertText As New InsertTextControl
   

   private InsertTextControl insertText = new InsertTextControl();
   

2. Ajoutez le code suivant au gestionnaire d'événements Startup de la classe ThisDocument.

   Me.ActionsPane.Controls.Add(insertText)
   

   this.ActionsPane.Controls.Add(insertText);
   

Test de l'application

Testez 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 lorsqu'un utilisateur clique sur le bouton.

Pour tester votre document

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

2. Vérifiez que le volet Actions est visible.

3. Tapez votre nom et votre adresse dans les zones de texte sur le volet Actions et cliquez sur Insérer.

Étapes suivantes

Vous devrez peut-être ensuite exécuter les opérations suivantes :

• Création d'un volet Actions dans Excel. Pour plus d'informations, consultez Comment : ajouter un volet Actions à des classeurs Excel.

• Liaison de données aux contrôles d'un volet Actions Pour plus d'informations, consultez Procédure pas à pas : liaison de données aux contrôles dans un volet Actions Word.

• Affichage et masquage de contrôles dans le volet Actions. Pour plus d'informations, consultez Procédure pas à pas : modification du volet Actions en fonction du contexte utilisateur.

Voir aussi

Tâches

Comment : ajouter un volet Actions à des documents Word

Comment : ajouter un volet Actions à des classeurs Excel

Procédure pas à pas : modification du volet Actions en fonction du contexte utilisateur

Comment : gérer la disposition des contrôles dans les volets Actions

Concepts

Bookmark, contrôle

Autres ressources

Vue d'ensemble du volet Actions