Run Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen einzelnen Abschnitt mit formatiertem oder unformatiertem Text dar.
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 : InlinePublic NotInheritable Class Run
Inherits Inline<Run .../>
-or-
<Run ...>text</Run>
- Vererbung
- Attribute
Beispiele
Jedes hier gezeigte Beispiel rendert dasselbe Ergebnis. Das Direkte Festlegen der Text-Eigenschaft auf dem TextBlock hat jedoch die beste Leistung.
<!-- 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 einzelnen Abschnitt mit formatiertem oder unformatiertem Text dar und kann in einem TextBlock - oder RichTextBlock-Objekt 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 für eine optimale Leistung fest. In der Regel verwenden Sie das Run-Element nur, wenn Sie einen separaten Textabschnitt innerhalb des TextBlock-Elements formatieren möchten.
Weitere Beispiele finden Sie unter
Konstruktoren
| Name | Beschreibung |
|---|---|
| Run() |
Initialisiert eine neue Instanz der Run-Klasse . |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AccessKey |
Dient zum Abrufen oder Festlegen der Zugriffstaste für dieses Element. (Geerbt von TextElement) |
| AccessKeyScopeOwner |
Dient zum Abrufen oder Festlegen eines Quellelements, das den Zugriffstastenbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet. (Geerbt von TextElement) |
| AllowFocusOnInteraction |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer damit interagiert. (Geerbt von TextElement) |
| CharacterSpacing |
Ruft den gleichmäßigen Abstand zwischen Zeichen in Einheiten von 1/1000 einer Em ab oder legt den einheitlichen Abstand fest. (Geerbt von TextElement) |
| ContentEnd |
Ruft einen TextPointer , der das Ende des Inhalts im Element darstellt. (Geerbt von TextElement) |
| ContentStart |
Ruft einen TextPointer , der den Anfang des Inhalts im Element darstellt. (Geerbt von TextElement) |
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
| ElementEnd |
Ruft einen TextPointer , der die Position direkt nach dem Ende des Elements darstellt. (Geerbt von TextElement) |
| ElementStart |
Ruft einen TextPointer , der die Position unmittelbar vor dem Start des Elements darstellt. (Geerbt von TextElement) |
| ExitDisplayModeOnAccessKeyInvoked |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zugriffstastenanzeige geschlossen wird, wenn eine Zugriffstaste aufgerufen wird. (Geerbt von TextElement) |
| FlowDirection |
Ruft die Richtung ab, in der Text und andere Benutzeroberflächenelemente innerhalb des Run-Elements fließen, das das Layout steuert, oder legt diese fest. |
| FlowDirectionProperty |
Identifies the FlowDirection dependency property. |
| FontFamily |
Ruft die bevorzugte Schriftfamilie der obersten Ebene für den Inhalt des Elements ab oder legt diese fest. (Geerbt von TextElement) |
| FontSize |
Dient zum Abrufen oder Festlegen des Schriftgrads für den Inhalt des Elements. (Geerbt von TextElement) |
| FontStretch |
Dient zum Abrufen oder Festlegen der Glyphebreite der Schriftart in einer Familie, die ausgewählt werden soll. (Geerbt von TextElement) |
| FontStyle |
Dient zum Abrufen oder Festlegen des Schriftschnitts für den Inhalt in diesem Element. (Geerbt von TextElement) |
| FontWeight |
Dient zum Abrufen oder Festlegen der Schriftstärke der obersten Ebene, die aus der Schriftartfamilie für den Inhalt in diesem Element ausgewählt werden soll. (Geerbt von TextElement) |
| Foreground |
Dient zum Abrufen oder Festlegen des Pinsels , der auf den Inhalt in diesem Element angewendet werden soll. (Geerbt von TextElement) |
| IsAccessKeyScope |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Element seinen eigenen Zugriffstastenbereich definiert. (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 |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit links oder rechts die Zugriffstasteninfo im Verhältnis zum Textelement platziert wird. (Geerbt von TextElement) |
| KeyTipPlacementMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo die Zugriffstasteninfo im Verhältnis zum Textelement platziert wird. (Geerbt von TextElement) |
| KeyTipVerticalOffset |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit nach oben oder unten die Zugriffstasteninfo im Verhältnis zum Textelement platziert wird. (Geerbt von TextElement) |
| Language |
Ruft Lokalisierungs-/Globalisierungsspracheninformationen ab, die für ein TextElement gelten, oder legt diese fest. (Geerbt von TextElement) |
| Name |
Dient zum Abrufen oder Festlegen einer eindeutigen Identifikation für das Objekt. Der Name kann nur aus der anfänglichen Analyse von XAML festgelegt werden. (Geerbt von TextElement) |
| Text |
Dient zum Abrufen oder Festlegen des Textinhalts der Ausführung. |
| TextDecorations |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, welche Dekorationen auf den Text angewendet werden. (Geerbt von TextElement) |
| XamlRoot |
Dient zum Abrufen oder Festlegen des XamlRoot-Elements, in dem dieses Element angezeigt wird. (Geerbt von TextElement) |
Methoden
| Name | Beschreibung |
|---|---|
| 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 Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, 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 wird. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (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 durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
Ereignisse
| Name | Beschreibung |
|---|---|
| AccessKeyDisplayDismissed |
Tritt auf, wenn die Zugriffstastenabfolge abgeschlossen ist, um Steuerelemente zu benachrichtigen, dass sie visuelle Zugriffstasten ausblenden sollen. (Geerbt von TextElement) |
| AccessKeyDisplayRequested |
Tritt auf, wenn die Zugriffstastenabfolge gestartet wird, um Steuerelemente zu benachrichtigen, dass sie visuelle Zugriffstasten anzeigen sollen. (Geerbt von TextElement) |
| AccessKeyInvoked |
Tritt auf, wenn ein Benutzer eine Zugriffstastensequenz abgeschlossen hat, um das Element zu benachrichtigen, dass die Zugriffstastenaktion aufgerufen werden soll. (Geerbt von TextElement) |