TextElement Classe

Définition

Espace de noms:: Microsoft.UI.Xaml.Documents

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Classe abstraite utilisée comme classe de base pour les classes Block et Inline également abstraites. TextElement prend en charge l’API commune 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(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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é: Microsoft.UI.Xaml.Documents.Block

Microsoft.UI.Xaml.Documents.Inline

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 de 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 des moyens supplémentaires de mettre en forme du texte, mais ceux-ci ne sont pas directement pris en charge par TextElement. Au lieu de cela, vous pouvez utiliser les propriétés jointes de la classe Typographie . Les propriétés jointes typographiques prennent généralement en charge les caractéristiques typographiques ou conventions avancées, telles que l’accès aux caractéristiques 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, et cela influence le comportement des variantes de police comme 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 intrinsèquement un point de connexion vers une arborescence visuelle XAML. En d’autres termes, un TextElement définit le modèle texte et objet de 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 la Windows Runtime :

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

Note

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

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

TextElement a quatre propriétés qui fournissent l’accès 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 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 la vue d’ensemble des propriétés de dépendance.

Classes dérivées textElement

TextElement est la classe parente pour deux classes dérivées qui divisent le modèle objet texte en deux conventions d’utilisation de texte : Block et Inline. Les classes bloc et inline sont considérées comme des classes de base (vous ne voyez généralement pas de <Block> balise en XAML) et existent principalement dans la hiérarchie 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 bloc et inline, consultez Bloc de texte.

Propriétés

Nom	Description
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 clé d’accès pour cet élément, même s’il n’est 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	Retourne `null` toujours dans une application du Kit de développement logiciel (SDK) d’application Windows. Utilisez DispatcherQueue à la place. (Hérité de DependencyObject)
DispatcherQueue	Obtient le `DispatcherQueue` résultat auquel cet objet est associé. Représente `DispatcherQueue` une installation qui peut accéder au `DependencyObject` thread d’interface utilisateur même si le code est initié par un thread non-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 préférée 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 pour le contenu de cet élément.
FontStyleProperty	Identifie la propriété de dépendance FontStyle .
FontWeight	Obtient ou définit l’épaisseur 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 de premier plan .
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’élargissement 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 gauche ou la droite de l’info-bulle placée 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-bulle 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 TextElement.
LanguageProperty	Identifie la propriété de dépendance de langage .
Name	Obtient ou définit une identification unique pour l’objet. Le nom ne peut être défini qu’à partir de l’analyse initiale du code 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 en cours d’affichage.

Méthodes

Nom	Description
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/ graphique d’objet runtime en référençant la valeur d’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 DependencyObject. (Hérité de DependencyObject)
OnDisconnectVisualChildren()	Remplacez cette méthode pour implémenter le comportement de la disposition et de la logique lorsque les éléments sont supprimés d’un contenu spécifique à une classe ou d’une propriété enfant.
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 à une dependencyProperty spécifique sur cette 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 qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

Événements

Nom	Description
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 les visuels de clé d’accès.
AccessKeyInvoked	Se produit lorsqu’un utilisateur termine une séquence de clés d’accès pour avertir l’élément que l’action de clé d’accès doit être appelée.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?