Procédure pas à pas : modification de la mise en forme d'un document à l'aide de contrôles CheckBox
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
Version de Microsoft Office
Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet. |
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.
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 voir le résultat sous la forme d'un exemple complet, consultez Contrôles Word, exemple.
Remarque : |
---|
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'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 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 Visual Studio Tools pour Office.
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
Text
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
Name
applyItalicFont
Text
Italic
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
Name
applyUnderlineFont
Text
Underline
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 Visual Studio Tools pour 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 programme 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