Partager via


TextElement Classe

Définition

Classe abstraite utilisée comme classe de base pour les classes Block et Inline également abstraites. TextElement prend en charge l’API courante pour les classes impliquées dans le modèle objet de texte XAML, telles que les propriétés qui contrôlent la taille du texte, les familles de polices, etc.

public ref class TextElement : DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TextElement : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class TextElement : DependencyObject
Public Class TextElement
Inherits DependencyObject
Héritage
Object Platform::Object IInspectable DependencyObject TextElement
Dérivé
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Les différentes propriétés définies par TextElement prennent en charge une API commune pour les classes impliquées dans le modèle objet texte XAML. Voici une liste des propriétés les plus couramment utilisées :

En définissant les propriétés TextElement, vous pouvez appliquer des propriétés de mise en forme de texte courantes au texte, à la fois dans les blocs et dans les lignes. Il existe également d’autres façons de mettre en forme le texte, mais celles-ci ne sont pas prises en charge directement par TextElement. Au lieu de cela, vous pouvez utiliser les propriétés jointes de la classe Typography . Les propriétés typographiques jointes prennent généralement en charge les conventions ou fonctionnalités typographiques avancées, telles que l’accès aux fonctionnalités typographiques définies au niveau de la police qui ne sont pas nécessairement prises en charge par toutes les polices. Par exemple, vous pouvez définir Typography.Variants en tant que propriété jointe sur n’importe quel bloc de texte ou inline, ce qui influencerait le comportement des variantes de police tel qu’activé par la police particulière que vous avez choisie pour définir FontFamily sur cet élément de texte.

TextElement ne définit pas de point de connexion à une arborescence visuelle XAML. En d’autres termes, un TextElement définit le texte et le modèle objet texte dans ce texte, mais il n’active pas encore l’affichage de ce texte dans une interface utilisateur. Pour cela, vous devez utiliser l’un des contrôles ou éléments descendants d’UIElement et qui peuvent être connectés à l’arborescence XAML et au visuel racine de votre fenêtre d’application. Il existe deux éléments de ce type dans le Windows Runtime :

  • TextBlock : prend en charge un modèle objet texte d’inlines uniquement avec sa collection Inlines .
  • RichTextBlock : prend en charge un modèle objet texte de bloc avec sa collection Blocks . Les blocs peuvent contenir des blocs et des lignes.

Notes

PasswordBox, RichEditBox et TextBox ne prennent pas en charge un modèle objet texte basé sur TextElement. RichEditBox active l’accès par programmation à un autre modèle objet texte via l’interface ITextDocument .

TextElement définit l’API qui prend en charge l’examen du modèle objet texte en tant qu’objets de programmation après l’analyse du XAML. En particulier, TextElement implémente Name et Language, qui sont des propriétés parallèles du même nom sur FrameworkElement. TextElement implémente également FindName (une méthode utilitaire permettant de rechercher des objets au moment de l’exécution en fonction de la façon dont Name a été défini dans le XAML initial) et OnDisconnectVisualChildren (pour les scénarios avancés et la prise en charge du concepteur).

TextElement a quatre propriétés qui permettent d’accéder aux objets TextPointer à partir du texte. Ces propriétés sont les suivantes : ContentStart, ContentEnd, ElementStart, ElementEnd. Un objet TextPointer Windows Runtime vous donne un point d’entrée pour la traversée du contenu. Pour plus d’informations, consultez TextPointer.

TextElement est une classe dérivée de DependencyObject. Cela signifie qu’il peut définir des propriétés de dépendance et que chacune des propriétés en lecture-écriture de TextElement est une propriété de dépendance, avec son identificateur de propriété également défini par TextElement. Pour plus d’informations sur les propriétés de dépendance activées, consultez Vue d’ensemble des propriétés de dépendance.

Classes dérivées textElement

TextElement est la classe parente de deux classes dérivées qui divisent le modèle objet texte en deux conventions d’utilisation du texte : Block et Inline. Block et Inline sont toutes deux considérées comme des classes de base (vous ne voyez généralement pas de <Block> balise en XAML) et existent dans la hiérarchie principalement pour être la classe parente d’autres éléments de texte pratiques. Par exemple, Block est la classe parente de Paragraph. Pour plus d’informations sur l’utilisation des éléments blocs et inline, consultez Démarrage rapide : Affichage du texte.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 AccessKey
1607 14393 AllowFocusOnInteraction
1607 14393 ExitDisplayModeOnAccessKeyInvoked
1703 15063 AccessKeyDisplayDismissed
1703 15063 AccessKeyDisplayRequested
1703 15063 AccessKeyInvoked
1703 15063 AccessKeyScopeOwner
1703 15063 IsAccessKeyScope
1703 15063 KeyTipHorizontalOffset
1703 15063 KeyTipPlacementMode
1703 15063 KeyTipVerticalOffset
1703 15063 Textdecorations
1903 18362 XamlRoot

Propriétés

AccessKey

Obtient ou définit la clé d’accès pour cet élément.

AccessKeyProperty

Identifie la propriété de dépendance AccessKey .

AccessKeyScopeOwner

Obtient ou définit un élément source qui fournit l’étendue de la clé d’accès pour cet élément, même s’il ne se trouve pas dans l’arborescence visuelle de l’élément source.

AccessKeyScopeOwnerProperty

Identifie la propriété de dépendance AccessKeyScopeOwner .

AllowFocusOnInteraction

Obtient ou définit une valeur qui indique si l’élément obtient automatiquement le focus lorsque l’utilisateur interagit avec lui.

AllowFocusOnInteractionProperty

Identifie la propriété de dépendance AllowFocusOnInteraction .

CharacterSpacing

Obtient ou définit l’espacement uniforme entre les caractères, en unités de 1/1000 d’un em.

CharacterSpacingProperty

Identifie la propriété de dépendance CharacterSpacing .

ContentEnd

Obtient un TextPointer qui représente la fin du contenu dans l’élément .

ContentStart

Obtient un TextPointer qui représente le début du contenu dans l’élément.

Dispatcher

Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une installation qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur.

(Hérité de DependencyObject)
ElementEnd

Obtient un TextPointer qui représente la position juste après la fin de l’élément.

ElementStart

Obtient un TextPointer qui représente la position juste avant le début de l’élément.

ExitDisplayModeOnAccessKeyInvoked

Obtient ou définit une valeur qui spécifie si l’affichage de la clé d’accès est ignoré lorsqu’une clé d’accès est appelée.

ExitDisplayModeOnAccessKeyInvokedProperty

Identifie la propriété de dépendance ExitDisplayModeOnAccessKeyInvoked .

FontFamily

Obtient ou définit la famille de polices de niveau supérieur par défaut pour le contenu de l’élément.

FontFamilyProperty

Identifie la propriété de dépendance FontFamily .

FontSize

Obtient ou définit la taille de police pour le contenu de l’élément.

FontSizeProperty

Identifie la propriété de dépendance FontSize .

FontStretch

Obtient ou définit la largeur du glyphe de la police dans une famille à sélectionner.

FontStretchProperty

Identifie la propriété de dépendance FontStretch .

FontStyle

Obtient ou définit le style de police du contenu de cet élément.

FontStyleProperty

Identifie la propriété de dépendance FontStyle .

FontWeight

Obtient ou définit le poids de police de niveau supérieur à sélectionner dans la famille de polices pour le contenu de cet élément.

FontWeightProperty

Identifie la propriété de dépendance FontWeight .

Foreground

Obtient ou définit le pinceau à appliquer au contenu de cet élément.

ForegroundProperty

Identifie la propriété de dépendance foreground .

IsAccessKeyScope

Obtient ou définit une valeur qui indique si un élément définit sa propre étendue de clé d’accès.

IsAccessKeyScopeProperty

Identifie la propriété de dépendance IsAccessKeyScope .

IsTextScaleFactorEnabled

Obtient ou définit si l’agrandissement automatique du texte, pour refléter le paramètre de taille de texte système, est activé.

IsTextScaleFactorEnabledProperty

Identifie la propriété de dépendance IsTextScaleFactorEnabled .

KeyTipHorizontalOffset

Obtient ou définit une valeur qui indique la distance à gauche ou à droite de l’info-bulle par rapport à l’élément de texte.

KeyTipHorizontalOffsetProperty

Identifie la propriété de dépendance KeyTipHorizontalOffset .

KeyTipPlacementMode

Obtient ou définit une valeur qui indique où l’info-clé est placée par rapport à l’élément de texte.

KeyTipPlacementModeProperty

Identifie la propriété de dépendance KeyTipPlacementMode .

KeyTipVerticalOffset

Obtient ou définit une valeur qui indique jusqu’à quel point l’info-bulle est placée par rapport à l’élément de texte.

KeyTipVerticalOffsetProperty

Identifie la propriété de dépendance KeyTipVerticalOffset .

Language

Obtient ou définit les informations de langue de localisation/globalisation qui s’appliquent à un élément TextElement.

LanguageProperty

Identifie la propriété de dépendance Language .

Name

Obtient ou définit une identification unique pour l’objet. Le nom ne peut être défini qu’à partir de l’analyse initiale de XAML.

TextDecorations

Obtient ou définit une valeur qui indique les décorations appliquées au texte.

TextDecorationsProperty

Identifie la propriété de dépendance TextDecorations .

XamlRoot

Obtient ou définit le XamlRoot dans lequel cet élément est visualisé.

Méthodes

ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété de dépendance.

(Hérité de DependencyObject)
FindName(String)

Récupère un objet dans le modèle objet/le graphique d’objet runtime en référençant la valeur de l’attribut x:Name ou Name de l’objet.

GetAnimationBaseValue(DependencyProperty)

Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active.

(Hérité de DependencyObject)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet DependencyObject.

(Hérité de DependencyObject)
OnDisconnectVisualChildren()

Remplacez cette méthode pour implémenter le comportement de la disposition et de la logique lorsque des éléments sont supprimés d’un contenu ou d’une propriété enfant spécifique à une classe.

ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie.

(Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject.

(Hérité de DependencyObject)
SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance sur un DependencyObject.

(Hérité de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback.

(Hérité de DependencyObject)

Événements

AccessKeyDisplayDismissed

Se produit lorsque la séquence de clés d’accès est terminée pour avertir les contrôles qu’ils doivent masquer les visuels de clé d’accès.

AccessKeyDisplayRequested

Se produit lorsque la séquence de clés d’accès est démarrée pour avertir les contrôles qu’ils doivent afficher des visuels de clé d’accès.

AccessKeyInvoked

Se produit lorsqu’un utilisateur termine une séquence de clés d’accès pour informer l’élément que l’action de clé d’accès doit être appelée.

S’applique à

Voir aussi