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

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Version de Microsoft Office Word 2007 Word 2003 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau du document

Version de Microsoft Office

Word 2007
Word 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

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.

Cette procédure pas à pas illustre 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.

Remarque :
Votre ordinateur risque d'afficher des noms ou des emplacements différents pour certains éléments de l'interface utilisateur Visual Studio 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 Paramètres Visual Studio.

Composants requis

Vous avez besoin des composants suivants pour exécuter cette procédure pas à pas :

Visual Studio Tools pour Office (composant facultatif de Visual Studio 2008 Professional et Visual Studio Team System)
Microsoft Office Word 2003 ou Microsoft Office Word 2007.

Visual Studio Tools pour Office est installé par défaut avec les versions répertoriées de Visual Studio. Pour vérifier s'il est installé, consultez Installation de Visual Studio Tools pour Office.

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 Visual Studio Tools pour Office.

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

Name

Address

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

À 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.

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

Remarque :
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.

Dans la fenêtre Propriétés, remplacez la propriété Name de Bookmark1 par showName.
Sélectionnez le mot Address, sans sélectionner la marque de paragraphe.
Exécutez l'une des étapes suivantes :
- Dans Word 2003 : Dans le menu Insertion, cliquez sur Signet.
- Dans Word 2007 : Dans l'onglet Insertion du Ruban, cliquez sur Signet dans le groupe Liens.
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

Sélectionnez le projet My Basic Actions Pane dans l'Explorateur de solutions.
Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
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

Si le contrôle de volet Actions n'est pas visible dans le concepteur, double-cliquez sur InsertTextControl.
À 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.
Remplacez la propriété Text du contrôle Label par Name.
Ajoutez un contrôle Textbox au contrôle de volet Actions et modifiez les propriétés suivantes.

Propriété

Valeur

Name

getName

Size

130, 20
Ajoutez un deuxième contrôle Label au contrôle de volet Actions et remplacez la propriété Text par Address.
Ajoutez un deuxième contrôle Textbox au contrôle de volet Actions et modifiez les propriétés suivantes.

Propriété

Valeur

Name

getAddress

Accepts Return

True

Multiline

True

Size

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

Propriété

Valeur

Name

addText

Text

Insérer

Propriété	Valeur
Name	getName
Size	130, 20

Propriété	Valeur
Name	getAddress
Accepts Return	True
Multiline	True
Size	130, 40

Propriété	Valeur
Name	addText
Text	Insérer

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 Visual Studio Tools pour Office.

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

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

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 Visual Studio Tools pour 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

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

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

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

Appuyez sur F5 pour exécuter votre projet.
Vérifiez que le volet Actions est visible.
Tapez votre nom et votre adresse dans les zones de texte sur le volet Actions et cliquez sur Insérer.