Procédure pas à pas : modification de la mise en forme d'un document à l'aide de contrôles CheckBox
Cette procédure pas à pas montre comment utiliser des contrôles Windows Forms dans une personnalisation au niveau du document pour Microsoft Office Word, afin de modifier la mise en forme du texte.
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 :
Ajout de texte et d'un contrôle au document dans un projet au niveau du document au moment du design.
Mise en forme du texte lorsqu'une option est sélectionnée.
Pour consulter le résultat sous forme d'exemple terminé, consultez les exemples de contrôles Word dans Exemples et procédures pas à pas relatifs au développement Office.
[!REMARQUE]
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur de 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
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 appelez-le My Word Formatting.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 Word Formatting à l'Explorateur de solutions.
Ajout de texte et de contrôles au document Word
Pour cette procédure pas à pas, ajoutez trois cases à cocher et du texte dans un contrôle Bookmark au document Word.Les cases à cocher présenteront des options à l'utilisateur pour mettre en forme le texte.
Pour ajouter trois cases à cocher
Vérifiez que le document est ouvert dans le concepteur Visual Studio.
À partir de l'onglet Contrôles communs de la Boîte à outils, faites glisser le premier contrôle CheckBox sur le document.
Dans la fenêtre Propriétés, modifiez les propriétés suivantes.
Propriété
Valeur
Nom
applyBoldFont
du texte ;
Bold
Appuyez sur Entrée pour déplacer le point d'insertion sous la première case à cocher.
Ajoutez une deuxième case à cocher au document sous la case à cocher ApplyBoldFont et modifiez les propriétés suivantes :
Propriété
Valeur
Nom
applyItalicFont
du texte ;
Italique
Appuyez sur Entrée pour déplacer le point d'insertion sous la deuxième case à cocher.
Ajoutez une troisième case à cocher au document sous la case à cocher ApplyItalicFont et modifiez les propriétés suivantes.
Propriété
Valeur
Nom
applyUnderlineFont
du texte ;
Souligné
Pour ajouter du texte et un contrôle Bookmark
Déplacez le point d'insertion sous les contrôles des cases à cocher et tapez le texte suivant :
Activez une case à cocher pour modifier la mise en forme de ce texte.
À partir de l'onglet Contrôles Word de la Boîte à outils, faites glisser un contrôle Bookmark sur le document.
La boîte de dialogue Ajouter un contrôle Bookmark s'affiche.
Sélectionnez le texte que vous avez ajouté au document et cliquez sur OK.
Un contrôle Bookmark nommé Bookmark1 est ajouté au texte sélectionné dans le document.
Dans la fenêtre Propriétés, remplacez la valeur de la propriété (Nom) par fontText**.**
Ensuite, écrivez le code pour que le texte soit mis en forme lorsqu'une case à cocher est activée ou désactivée.
Mise en forme du texte lorsqu'une case à cocher est activée ou désactivée
Lorsque l'utilisateur sélectionne une option de mise en forme, modifiez la mise en forme du texte dans le document.
Pour modifier la mise en forme lorsqu'une case à cocher est activée
Cliquez avec le bouton droit sur ThisDocument dans l'Explorateur de solutions, puis cliquez sur Afficher le code dans le menu contextuel.
Pour C# uniquement, ajoutez les constantes suivantes à la classe ThisDocument.
const int WordTrue = -1; const int WordFalse = 0;
Ajoutez le code suivant au gestionnaire d'événements Click de la case à cocher applyBoldFont.
Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyBoldFont.Click Me.fontText.Bold = Me.applyBoldFont.Checked End Sub
private void applyBoldFont_Click(object sender, System.EventArgs e) { if (this.applyBoldFont.Checked == true) { this.fontText.Bold = WordTrue; } else { this.fontText.Bold = WordFalse; } }
Ajoutez le code suivant au gestionnaire d'événements Click de la case à cocher applyItalicFont.
Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyItalicFont.Click Me.fontText.Italic = Me.applyItalicFont.Checked End Sub
private void applyItalicFont_Click(object sender, System.EventArgs e) { if (this.applyItalicFont.Checked == true) { this.fontText.Italic = WordTrue; } else { this.fontText.Italic = WordFalse; } }
Ajoutez le code suivant au gestionnaire d'événements Click de la case à cocher applyUnderlineFont.
Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyUnderlineFont.Click If Me.applyUnderlineFont.Checked Then Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle Else Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone End If End Sub
private void applyUnderlineFont_Click(object sender, System.EventArgs e) { if (this.applyUnderlineFont.Checked == true) { this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle; } else { this.fontText.Underline = Word.WdUnderline.wdUnderlineNone; } }
En C#, vous devez ajouter des gestionnaires d'événements pour les zones de texte à l'événement Startup.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.
this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click); this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click); this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);
Test de l'application
Vous pouvez maintenant tester votre document pour vérifier que le texte est correctement mis en forme lorsque vous activez ou désactivez une case à cocher.
Pour tester votre document
Appuyez sur F5 pour exécuter votre projet.
Activez ou désactivez une case à cocher.
Vérifiez que le texte est correctement mis en forme.
Étapes suivantes
Cette procédure pas à pas présente les notions de base de l'utilisation des cases à cocher et de la modification par programmation de la mise en forme du texte dans les documents Word.Vous devrez peut-être ensuite exécuter les opérations suivantes :
Utilisez un bouton pour remplir une zone de texte.Pour plus d’informations, consultez Procédure pas à pas : affichage de texte dans une zone de texte d'un document à l'aide d'un bouton.
Utilisation de cases d'option pour sélectionner des styles de graphique.Pour plus d’informations, consultez Procédure pas à pas : mise à jour d'un graphique dans un document à l'aide de cases d'option.
Voir aussi
Concepts
Procédures pas à pas utilisant Word
Limitations des contrôles Windows Forms dans les documents Office
Autres ressources
Exemples et procédures pas à pas relatifs au développement Office