Partager via


Run Classe

Définition

Représente une section discrète de texte mis en forme ou non.

public ref class Run sealed : Inline
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 Run final : Inline
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class Run : Inline
Public NotInheritable Class Run
Inherits Inline
<Run .../>
-or-
<Run ...>text</Run>
Héritage
Object Platform::Object IInspectable DependencyObject TextElement Inline Run
Attributs

Exemples

Chaque exemple présenté ici affiche le même résultat. Toutefois, la définition de la propriété Text directement sur textBlock offre les meilleures performances.

<!-- Set the TextBlock.Text property directy for best performance. -->
<TextBlock Text="This is some text."/>

<TextBlock><Run>This is some text.</Run></TextBlock>

<TextBlock><Run Text="This is some text."></Run></TextBlock>
// Set the TextBlock.Text property directy for best performance.
TextBlock textblock = new TextBlock();
textblock.Text = "This is some text.";

TextBlock textblock = new TextBlock();
Run run = new Run();
run.Text = "This is some text.";
textblock.Inlines.Add(run);

Remarques

Un objet Run représente une section discrète de texte mis en forme ou non mis en forme et peut être utilisé dans un TextBlock ou RichTextBlock. Vous pouvez placer plusieurs éléments Run à l’intérieur d’une étendue.

Lorsque vous utilisez un TextBlock, définissez directement la propriété TextBlock.Text pour de meilleures performances. En règle générale, vous utilisez l’élément Run uniquement lorsque vous souhaitez mettre en forme une section discrète de texte dans textBlock.

Pour plus d’exemples, consultez

Constructeurs

Run()

Initialise une nouvelle instance de la classe Run.

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é. représente DispatcherQueue une fonctionnalité 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)
FlowDirection

Obtient ou définit la direction dans laquelle le texte et d’autres éléments d’interface utilisateur circulent dans l’élément Run qui contrôle leur disposition.

FlowDirectionProperty

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

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 des glyphes 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)
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 à quelle distance à gauche ou à droite l’info-bulle est 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 des 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 de XAML.

(Hérité de TextElement)
Text

Obtient ou définit le contenu du texte de l’objet Exécuter.

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 consulté.

(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 graphe d’objet du modèle 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’appliquerait 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 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 touches 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 touches 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 touches 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