Run Klasse

Definition

Stellt einen diskreten Abschnitt formatierten oder unformatierten Text dar.

public ref class Run sealed : Inline
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
class Run final : Inline
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Run final : Inline
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
public sealed class Run : Inline
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Run : Inline
Public NotInheritable Class Run
Inherits Inline
<Run .../>
-or-
<Run ...>text</Run>
Vererbung
Object Platform::Object IInspectable DependencyObject TextElement Inline Run
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Jedes hier gezeigte Beispiel rendert das gleiche Ergebnis. Das Festlegen der Text-Eigenschaft direkt im TextBlock weist jedoch die beste Leistung auf.

<!-- 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);

Hinweise

Eine Ausführung stellt einen diskreten Abschnitt formatierten oder unformatierten Text dar und kann in einem TextBlock oder RichTextBlock verwendet werden. Sie können mehrere Run-Elemente innerhalb eines Span-Elements platzieren.

Wenn Sie einen TextBlock verwenden, legen Sie die TextBlock.Text-Eigenschaft direkt fest, um eine optimale Leistung zu erzielen. Sie verwenden das Run-Element in der Regel nur, wenn Sie einen diskreten Textabschnitt im TextBlock formatieren möchten.

Weitere Beispiele finden Sie unter

Konstruktoren

Run()

Initialisiert eine neue instance der Run-Klasse.

Eigenschaften

AccessKey

Ruft den Zugriffsschlüssel für dieses Element ab oder legt diesen fest.

(Geerbt von TextElement)
AccessKeyScopeOwner

Ruft ein Quellelement ab, das den Zugriffsschlüsselbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet, oder legt es fest.

(Geerbt von TextElement)
AllowFocusOnInteraction

Ruft einen Wert ab, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer mit ihm interagiert, oder legt diesen fest.

(Geerbt von TextElement)
CharacterSpacing

Ruft den einheitlichen Abstand zwischen Zeichen in Einheiten von 1/1000 eines em ab oder legt diese fest.

(Geerbt von TextElement)
ContentEnd

Ruft einen TextPointer ab , der das Ende des Inhalts im -Element darstellt.

(Geerbt von TextElement)
ContentStart

Ruft einen TextPointer ab, der den Anfang des Inhalts im -Element darstellt.

(Geerbt von TextElement)
Dispatcher

Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird.

(Geerbt von DependencyObject)
ElementEnd

Ruft einen TextPointer ab, der die Position direkt nach dem Ende des Elements darstellt.

(Geerbt von TextElement)
ElementStart

Ruft einen TextPointer ab, der die Position kurz vor dem Start des Elements darstellt.

(Geerbt von TextElement)
ExitDisplayModeOnAccessKeyInvoked

Ruft einen Wert ab, der angibt, ob die Anzeige der Zugriffsschlüssel beim Aufrufen eines Zugriffsschlüssels geschlossen wird, oder legt diesen fest.

(Geerbt von TextElement)
FlowDirection

Ruft die Richtung ab, in die Text und andere Benutzeroberflächenelemente innerhalb des Run-Elements fließen, das ihr Layout steuert, oder legt diese fest.

FlowDirectionProperty

Identifiziert die FlowDirection-Abhängigkeitseigenschaft .

FontFamily

Ruft die bevorzugte Schriftfamilie der obersten Ebene für den Inhalt des Elements ab oder legt sie fest.

(Geerbt von TextElement)
FontSize

Ruft den Schriftgrad für den Inhalt des Elements ab oder legt ihn fest.

(Geerbt von TextElement)
FontStretch

Ruft die Glyphenbreite der Schriftart in einer Familie ab, die ausgewählt werden soll, oder legt sie fest.

(Geerbt von TextElement)
FontStyle

Ruft den Schriftstil für den Inhalt in diesem Element ab oder legt diesen fest.

(Geerbt von TextElement)
FontWeight

Ruft die Schriftstärke der obersten Ebene ab, die aus der Schriftfamilie für den Inhalt in diesem Element ausgewählt werden soll, oder legt diese fest.

(Geerbt von TextElement)
Foreground

Ruft den Pinsel ab, der auf den Inhalt in diesem Element angewendet werden soll, oder legt diesen fest.

(Geerbt von TextElement)
IsAccessKeyScope

Ruft einen Wert ab, der angibt, ob ein Element seinen eigenen Zugriffsschlüsselbereich definiert, oder legt diesen fest.

(Geerbt von TextElement)
IsTextScaleFactorEnabled

Ruft ab oder legt fest, ob die automatische Textvergrößerung aktiviert ist, um die Einstellung für die Systemtextgröße widerzuspiegeln.

(Geerbt von TextElement)
KeyTipHorizontalOffset

Ruft einen Wert ab, der angibt, wie weit links oder rechts die Keytip in Relation zum Textelement platziert wird, oder legt diesen fest.

(Geerbt von TextElement)
KeyTipPlacementMode

Ruft einen Wert ab, der angibt, wo die KeyTip in Relation zum Textelement platziert wird, oder legt diesen fest.

(Geerbt von TextElement)
KeyTipVerticalOffset

Ruft einen Wert ab, der angibt, wie weit nach oben oder unten die Keytip in Relation zum Textelement platziert wird, oder legt diesen fest.

(Geerbt von TextElement)
Language

Ruft Lokalisierungs-/Globalisierungsspracheninformationen ab, die für ein TextElement gelten, oder legt diese fest.

(Geerbt von TextElement)
Name

Ruft eine eindeutige Identifikation für das -Objekt ab oder legt diese fest. Der Name kann nur bei der anfänglichen Analyse von XAML festgelegt werden.

(Geerbt von TextElement)
Text

Ruft den Textinhalt der Ausführung ab oder legt diese fest.

TextDecorations

Ruft einen Wert ab, der angibt, welche Dekorationen auf den Text angewendet werden, oder legt diesen fest.

(Geerbt von TextElement)
XamlRoot

Ruft die XamlRoot ab, in der dieses Element angezeigt wird, oder legt diese fest.

(Geerbt von TextElement)

Methoden

ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Abhängigkeitseigenschaft.

(Geerbt von DependencyObject)
FindName(String)

Ruft ein Objekt im Objektmodell-/Laufzeitobjektdiagramm ab, indem auf den x:Name - oder Name-Attributwert des Objekts verwiesen wird.

(Geerbt von TextElement)
GetAnimationBaseValue(DependencyProperty)

Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist.

(Geerbt von DependencyObject)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück.

(Geerbt von DependencyObject)
OnDisconnectVisualChildren()

Überschreiben Sie diese Methode, um zu implementieren, wie sich Layout und Logik verhalten sollen, wenn Elemente aus einem klassenspezifischen Inhalt oder einer untergeordneten Eigenschaft entfernt werden.

(Geerbt von TextElement)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist.

(Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest.

(Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde.

(Geerbt von DependencyObject)

Ereignisse

AccessKeyDisplayDismissed

Tritt auf, wenn die Zugriffstastensequenz abgeschlossen ist, um Steuerelemente zu benachrichtigen, dass sie Zugriffstastenvisuals ausblenden sollen.

(Geerbt von TextElement)
AccessKeyDisplayRequested

Tritt auf, wenn die Zugriffsschlüsselsequenz gestartet wird, um Steuerelemente zu benachrichtigen, dass sie Zugriffstastenvisuals anzeigen sollen.

(Geerbt von TextElement)
AccessKeyInvoked

Tritt auf, wenn ein Benutzer eine Zugriffsschlüsselsequenz abschließt, um das Element zu benachrichtigen, dass die Zugriffstastenaktion aufgerufen werden soll.

(Geerbt von TextElement)

Gilt für:

Weitere Informationen