Span Classe
Définition
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.
/// [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 : InlinePublic 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 objet en 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 définissez 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 entourée.
L’exécution a des fonctionnalités similaires d’application de 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 des lignes supplémentaires).
Span prend en charge le contenu mixte si vous définissez le contenu en XAML. Cela signifie que vous pouvez combiner des balises inline telles que Run, Bold , etc. avec du contenu de texte XAML (texte brut), sans restrictions sur l’ordre dans lequel les balises et le texte doivent apparaître. Tout le texte, qu’il s’agisse de texte brut ou placé entre une balise inline , s’affiche 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 d’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.
Note
Placer du contenu XAML si des balises ou du texte directement dans un élément Span sont 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 dans inlineCollection, soit en tant qu’éléments enfants d’un paragraphe (devient partie de Paragraph.Inlines) soit comme contenu d’une autre étendue (devient une partie de Span.Inlines).
Classes dérivées span
Span est la classe parente pour plusieurs classes dérivées qui définissent une zone de texte inline avec une convention de mise en forme particulière :
Le lien hypertexte 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 au texte et n’ajoutent pas d’interaction.
Constructeurs
| Nom | Description |
|---|---|
| Span() |
Initialise une nouvelle instance de la classe Span . |
Propriétés
| Nom | Description |
|---|---|
| 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 clé d’accès pour cet élément, même s’il n’est 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 |
| DispatcherQueue |
Obtient le |
| 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 préférée 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 pour le contenu de cet élément. (Hérité de TextElement) |
| 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. (Hérité de TextElement) |
| Foreground |
Obtient ou définit le pinceau à appliquer au contenu de cet élément. (Hérité de TextElement) |
| Inlines |
Obtient un 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’élargissement 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 gauche ou la droite de l’info-bulle placée par rapport à l’élément de texte. (Hérité de TextElement) |
| KeyTipPlacementMode |
Obtient ou définit une valeur qui indique où l’info-bulle 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 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 du code 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 en cours d’affichage. (Hérité de TextElement) |
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. (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 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. (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 à 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. (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 les 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 avertir l’élément que l’action de clé d’accès doit être appelée. (Hérité de TextElement) |