Partager via


Span Classe

Définition

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
Dérivé
Attributs

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 :

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 à

Voir aussi