Mise en forme de texte avancée
Mise à jour : novembre 2007
Windows Presentation Foundation (WPF) fournit un jeu fiable d'API pour inclure du texte dans votre application. Layout et interface utilisateur (UI)API, tel que TextBlock, fournissent les éléments d'utilisation les plus courants et généraux pour la présentation de texte. Drawing API, tel que GlyphRunDrawing et FormattedText, permettent d'inclure un texte mise en forme dans des dessins. Au niveau le plus avancé, WPF, fournit un moteur de mise en forme de texte extensible pour contrôler chaque aspect de présentation de texte, telle que la gestion du magasin de texte, la gestion de l'exécution de texte et la gestion d'objet incorporé.
Cette rubrique présente la mise en forme du texte WPF. Elle porte principalement sur l'implémentation cliente et l'utilisation du moteur de mise en forme du texte WPF.
.gif "Remarque") Remarque : |
|---|
Tous les exemples de code dans ce document se trouvent dans la rubrique Mise en forme de texte avancée, exemple. |
Cette rubrique comprend les sections suivantes.
- Composants requis
- Mise en forme de texte avancée
- Utilisation du formateur de texte
- Implémentation du magasin de texte client
- Fourniture des exécutions de texte
- Spécification des propriétés de mise en forme
- Rubriques connexes
Composants requis
Cette rubrique suppose que vous connaissez le niveau supérieur API utilisé pour la présentation de texte. La plupart des scénarios utilisateur ne nécessitent pas les API de mise en forme de texte avancée décrites dans cette rubrique. Pour une présentation des différentes API texte, consultez Documents dans Windows Presentation Foundation.
Mise en forme de texte avancée
La mise en page de texte et les contrôles interface utilisateur dans WPF fournissent des propriétés de mise en forme qui permettent d'inclure facilement le texte mis en forme dans votre application. Ces contrôles exposent des propriétés pour gérer la présentation de texte, ce qui inclut sa police, sa taille et sa couleur. Dans des conditions normales, ces contrôles peuvent gérer la majorité de la présentation de texte dans votre application. Toutefois, certains scénarios avancés imposent de contrôler le stockage du texte et sa présentation. WPF fournit un moteur de mise en forme de texte extensible à cette fin.
Les fonctionnalités de mise en forme de texte avancée dans WPF sont constituées d'un moteur de mise en forme de texte, d'un magasin de texte, d'exécutions de texte et de propriétés de mise en forme. Le moteur de mise en forme du texte, TextFormatter, crée des lignes de texte à utiliser pour la présentation. Cela est accompli en initialisant le processus de la mise en forme de ligne et en appelant les FormatLine du formateur de texte. Le formateur de texte récupère les exécutions de texte de votre magasin de texte en appelant la méthode GetTextRun du magasin. Ensuite, les objets TextRun sont transformés en objets TextLine par le formateur de texte et transmis à votre application pour l'inspection ou l'affichage.
Utilisation du formateur de texte
TextFormatter est le moteur de mise en forme du texte WPF et il fournit des services pour mettre en forme et couper des lignes de texte. Le formateur de texte peut gérer différents formats de caractères alphabétiques et il prend en charge la présentation de texte internationale.
Contrairement à un API texte traditionnelle, le TextFormatter interagit avec le client de disposition de texte par l'intermédiaire d'un ensemble de méthodes de rappel. Cela suppose que le client fournisse ces méthodes dans une implémentation de la classe TextSource. Le diagramme suivant montre l'interaction de la disposition du texte entre l'application cliente et TextFormatter.
Interaction entre l'application et TextFormatter
.png)
Le formateur de texte est utilisé pour récupérer des lignes de texte mis en forme dans le magasin de texte qui est une implémentation de TextSource. Cette opération est effectuée en créant une instance du formateur de texte et en utilisant la méthode Create. Cette méthode crée une instance du formateur de texte et définit la hauteur et la largeur de ligne maximales. Dès qu'une instance du formateur de texte est créée, le processus de création de ligne est démarré en appelant la méthode FormatLine. Le TextFormatter effectue un rappel vers la source du texte pour extraire les paramètres de texte et de mise en forme des exécutions de texte qui forment une ligne.
L'exemple suivant montre le processus de mise en forme d'un magasin de texte. L'objet TextFormatter est utilisé pour récupérer des lignes de texte du magasin de texte et mettre en forme la ligne de texte pour la placer dans le DrawingContext.
Implémentation du magasin de texte client
Lorsque vous étendez le moteur de mise en forme du texte, vous devez implémenter et gérer tous les aspects du magasin de texte. Ce n'est pas une tâche simple. Le magasin de texte est chargé de suivre les propriétés d'exécution de texte, les propriétés de paragraphe, les objets incorporés et tout autre contenu semblable. Il fournit également au formateur de texte des objets TextRun individuels que le formateur de texte utilise pour créer des objets TextLine.
Pour gérer la virtualisation du magasin de texte, ce dernier doit être dérivé de TextSource. TextSource définit la méthode que le formateur de texte utilise pour récupérer des exécutions de texte du magasin de texte. GetTextRun est la méthode utilisée par le formateur de texte pour récupérer des exécutions de texte utilisées dans la mise en forme de ligne. L'appel à GetTextRun est exécuté de manière répétitive par le formateur de texte jusqu'à ce que l'une des conditions suivantes existe :
Un TextEndOfLine ou une sous-classe sont retournés.
La largeur cumulée des exécutions de texte dépasse la largeur de ligne maximale spécifiée dans l'appel pour créer le formateur de texte ou l'appel à la méthode FormatLine du formateur de texte.
Une séquence de saut de ligne Unicode, telle que "CF", "LF" ou "CRLF", est retournée.
Fourniture des exécutions de texte
Le cœur du processus de mise en forme du texte est l'interaction entre le formateur de texte et le magasin de texte. Votre implémentation TextSource fournit au formateur de texte les objets et les propriétés TextRun nécessaires à la mis en forme des exécutions de texte. Cette interaction est contrôlée par la méthode GetTextRun appelée par le formateur de texte.
Le tableau suivant répertorie certains des objets TextRun prédéfinis.
Type TextRun |
Utilisation |
|---|---|
Exécution de texte spécialisée utilisée pour renvoyer une représentation des glyphes de caractères au formateur de texte. |
|
L'exécution de texte spécialisée utilisée pour fournir le contenu de mesure, le test d'atteinte et le dessin est effectuée globalement, tel qu'un bouton ou une image dans le texte. |
|
Exécution de texte spécialisée utilisée pour marquer la fin d'une ligne. |
|
Exécution de texte spécialisée utilisée pour marquer la fin d'un paragraphe. |
|
Exécution de texte spécialisée utilisée pour marquer la fin d'un segment, pour terminer, par exemple, la portée affectée par une exécution TextModifier précédente. |
|
Exécution de texte spécialisée utilisée pour marquer une plage de caractères cachés. |
|
Exécution de texte spécialisée utilisée pour modifier les propriétés d'exécutions de texte dans sa portée. La portée s'étend à l'exécution de texte TextEndOfSegment correspondante suivante ou au TextEndOfParagraph suivant. |
Chacun des objets TextRun prédéfinis peut être sous-classé. Cela permet à la source de texte de fournir au formateur de texte des exécutions de texte qui incluent des données personnalisées.
L'exemple de code suivant montre une méthode GetTextRun. Ce magasin de texte retourne des objets TextRun au formateur de texte pour les traiter.
| Remarque : |
|---|
Dans cet exemple, le magasin de texte fournit les mêmes propriétés de texte à l'ensemble du texte. Les magasins de textes avancés doivent implémenter leur propre gestion de plage pour que les caractères individuels aient des propriétés différentes. |
Spécification des propriétés de mise en forme
Les objets TextRun sont mis en forme en utilisant les propriétés fournies par le magasin de texte. Il existe deux types de propriétés : TextParagraphProperties et TextRunProperties. TextParagraphProperties gère les propriétés d'inclusion de paragraphes, telles que TextAlignment et FlowDirection. TextRunProperties sont des propriétés qui peuvent être différentes pour chaque exécution de texte dans un paragraphe, telle que le pinceau de premier plan, Typeface et la taille de police. Pour implémenter des types de propriétés de paragraphe personnalisé et d'exécution de texte personnalisé, votre application doit créer des classes dérivées de TextParagraphProperties et de TextRunProperties, respectivement.