Span Classe

Référence

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

Regroupe d’autres éléments de contenu inline . Classe parente pour Bold, Hyperlink, Italic et Soulignement.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [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 Span : Inline

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[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 Span : Inline

Public Class Span
Inherits Inline

<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>

Héritage: Object IInspectable DependencyObject TextElement Inline Span

Dérivé: Microsoft.UI.Xaml.Documents.Bold

Microsoft.UI.Xaml.Documents.Hyperlink

Microsoft.UI.Xaml.Documents.Italic

Microsoft.UI.Xaml.Documents.Underline

Attributs: ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Remarques

Vous pouvez utiliser Span comme élément d’objet dans XAML pour placer du texte. Cela permet une utilisation similaire à la façon dont vous pouvez utiliser la span balise en HTML. Pour cette utilisation, vous devez définir les attributs pris en charge par TextElement , tels que FontSize ou FontFamily, afin de pouvoir appliquer ces décisions de mise en forme de texte à l’étendue de texte placée. Run a des fonctionnalités similaires d’application des propriétés TextElement à une plage de texte, mais Run ne prend pas en charge le contenu mixte (sa propriété de contenu XAML Run.Text ne peut contenir que du texte, pas du contenu mixte et d’autres inlines).

Span prend en charge le contenu mixte si vous définissez le contenu en XAML. Cela signifie que vous pouvez mélanger des balises inline telles que Run, Bold , etc. avec du contenu de texte XAML (texte brut), sans aucune restriction quant à l’ordre dans lequel les balises et le texte doivent apparaître. Tout le texte, qu’il s’agisse de texte brut ou placé dans une balise inline , est rendu dans l’ordre dans lequel le texte est défini dans le contenu mixte. Par exemple, il s’agit du code XAML légal :

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

Lorsque le contenu mixte est analysé à partir de XAML et que le modèle objet texte est examiné au moment de l’exécution, toute zone de texte provenant du texte brut génère un objet Run à la position de l’ordre de lecture appropriée dans la classe de collection InlineCollection qui permet l’accès au moment de l’exécution. Cet élément Run contient le texte, mais n’a pas de propriétés définies.

Notes

Le placement du contenu XAML, qu’il s’agisse d’étiquettes ou de texte directement dans un élément Span, est pris en charge, car Span indique que sa propriété Inlines est la propriété de contenu XAML. Pour plus d’informations sur les propriétés de contenu XAML, consultez la section « Propriétés de contenu XAML » du guide de syntaxe XAML.

Les éléments Span sont généralement utilisés en tant qu’éléments au sein d’un InlineCollection, soit en tant qu’éléments enfants d’un Paragraphe (devient partie intégrante de Paragraph.Inlines), soit en tant que contenu d’une autre Span (devient partie intégrante de Span.Inlines).

Classes dérivées de l’étendue

Span est la classe parente de plusieurs classes dérivées qui définissent une région de texte inline avec une convention de mise en forme particulière :

Gras
Lien hypertexte
Italique
Le lien hypertexte de soulignement active un comportement de clic qui accède à NavigateUri. Les autres classes dérivées de Span peuvent être considérées comme des décorations spécifiques à la classe du texte et n’ajoutent pas d’interaction.

Constructeurs

Span()

Initialise une nouvelle instance de la classe Span.

Propriétés

AccessKey	Obtient ou définit la clé d’accès pour cet élément. (Hérité de TextElement)
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. (Hérité de TextElement)
AllowFocusOnInteraction	Obtient ou définit une valeur qui indique si l’élément obtient automatiquement le focus lorsque l’utilisateur interagit avec lui. (Hérité de TextElement)
CharacterSpacing	Obtient ou définit l’espacement uniforme entre les caractères, en unités de 1/1000 d’un em. (Hérité de TextElement)
ContentEnd	Obtient un TextPointer qui représente la fin du contenu dans l’élément . (Hérité de TextElement)
ContentStart	Obtient un TextPointer qui représente le début du contenu dans l’élément. (Hérité de TextElement)
Dispatcher	Retourne `null` toujours dans une application SDK d'application Windows. Utilisez DispatcherQueue à la place. (Hérité de DependencyObject)
DispatcherQueue	Obtient le `DispatcherQueue` auquel cet objet est associé. `DispatcherQueue` représente une installation qui peut accéder au `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. (Hérité de TextElement)
ElementStart	Obtient un TextPointer qui représente la position juste avant le début de l’élément. (Hérité de TextElement)
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. (Hérité de TextElement)
FontFamily	Obtient ou définit la famille de polices de niveau supérieur par défaut pour le contenu de l’élément. (Hérité de TextElement)
FontSize	Obtient ou définit la taille de police pour le contenu de l’élément. (Hérité de TextElement)
FontStretch	Obtient ou définit la largeur du glyphe de la police dans une famille à sélectionner. (Hérité de TextElement)
FontStyle	Obtient ou définit le style de police du contenu de cet élément. (Hérité de TextElement)
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. (Hérité de TextElement)
Foreground	Obtient ou définit le pinceau à appliquer au contenu de cet élément. (Hérité de TextElement)
Inlines	Obtient une inlineCollection contenant les éléments inline de niveau supérieur qui incluent le contenu de Span.
IsAccessKeyScope	Obtient ou définit une valeur qui indique si un élément définit sa propre étendue de clé d’accès. (Hérité de TextElement)
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é. (Hérité de TextElement)
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. (Hérité de TextElement)
KeyTipPlacementMode	Obtient ou définit une valeur qui indique où l’info-clé est placée par rapport à l’élément de texte. (Hérité de TextElement)
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. (Hérité de TextElement)
Language	Obtient ou définit les informations de langue de localisation/globalisation qui s’appliquent à un élément TextElement. (Hérité de TextElement)
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. (Hérité de TextElement)
TextDecorations	Obtient ou définit une valeur qui indique les décorations appliquées au texte. (Hérité de TextElement)
XamlRoot	Obtient ou définit le XamlRoot dans lequel cet élément est visualisé. (Hérité de TextElement)

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. (Hérité de TextElement)
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. (Hérité de TextElement)
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. (Hérité de TextElement)
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. (Hérité de TextElement)
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. (Hérité de TextElement)

S’applique à