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

Article
03/04/2013

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

[!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.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 Paramètres Visual Studio.

Composants requis

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

Une édition de Visual Studio 2012 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.110\).md).

Word 2013 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

À 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.
Sous l'onglet Insérer du ruban, dans le groupe Liens, cliquez sur Signet.
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

Nom

getName

Taille

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

Nom

getAddress

Accepts Return

True

Multiline

True

Taille

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

Propriété

Valeur

Nom

addText

du texte ;

Insert

Propriété	Valeur
Nom	getName
Taille	130, 20

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

Propriété	Valeur
Nom	addText
du 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

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

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.

É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 How to: Add an Actions Pane to Excel Workbooks.
Liaison de données aux contrôles d'un volet ActionsPour plus d’informations, consultez Procédure pas à pas : liaison de données aux contrôles dans un volet Actions Word.

Voir aussi

Partager via