Freigeben über

Textblock

  • Artikel

Textblock ist das primäre Steuerelement zum Anzeigen von schreibgeschütztem Text in Apps. Sie können es verwenden, um einzeiligen oder mehrzeiligen Text, Inlinelinks und Text mit Formatierung wie Fett, Kursiv oder Unterstrichen anzuzeigen.

Ist dies das richtige Steuerelement?

Ein Textblock ist in der Regel einfacher zu verwenden und bietet eine bessere Leistung beim Rendern von Text als ein Rich-Text-Block, daher wird er für die meisten Ui-Text der App bevorzugt. Sie können auf einfache Weise auf Text aus einem Textblock in Ihrer App zugreifen und diesen verwenden, indem Sie den Wert der Text-Eigenschaft abrufen. Es bietet auch viele der gleichen Formatierungsoptionen zum Anpassen der Darstellung des Texts.

Sie können zwar Zeilenumbrüche in den Text einfügen, jedoch ist der Textblock zum Anzeigen eines einzelnen Absatzes vorgesehen und unterstützt keinen Texteinzug. Verwenden Sie richTextBlock, wenn Sie Unterstützung für mehrere Absätze, mehrspaltigen Text oder andere komplexe Textlayouts oder Inline-UI-Elemente wie Bilder benötigen.

Weitere Informationen zur Auswahl des passenden Textsteuerelements finden Sie im Artikel Textsteuerelemente.

UWP und WinUI 2

Wichtig

Die Informationen und Beispiele in diesem Artikel sind für Apps optimiert, die das Windows App SDK und WinUI 3 verwenden, gelten jedoch allgemein für UWP-Apps, die WinUI 2 verwenden. In der UWP-API-Referenz finden Sie plattformspezifische Informationen und Beispiele.

Dieser Abschnitt enthält Informationen, die Sie zum Verwenden des Steuerelements in einer UWP- oder WinUI 2-App benötigen.

APIs für dieses Steuerelement sind im Windows.UI.Xaml.Controls-Namespace vorhanden.

Es wird empfohlen, die neueste WinUI 2-Version zu verwenden, um die aktuellsten Formatvorlagen, Vorlagen und Features für alle Steuerelemente abzurufen.

Erstellen eines Textblocks

Öffnen Sie die WinUI 3 Gallery-App, und sehen Sie den TextBlock in Aktion.

Die WinUI 3-Katalog-App umfasst interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Laden Sie die App aus dem Microsoft Store herunter, oder rufen Sie den Quellcode auf GitHub ab

Hier erfahren Sie, wie Sie ein einfaches TextBlock-Steuerelement definieren und dessen Texteigenschaft auf eine Zeichenfolge festlegen.

<TextBlock Text="Hello, world!" />

TextBlock textBlock1 = new TextBlock();
textBlock1.Text = "Hello, world!";

Inhaltsmodell

Es gibt zwei Eigenschaften, mit denen Sie einem TextBlock Inhalte hinzufügen können: Text und Inlines.

Die am häufigsten verwendete Möglichkeit zum Anzeigen von Text besteht darin, die Text-Eigenschaft auf einen Zeichenfolgenwert festzulegen, wie im vorherigen Beispiel gezeigt.

Sie können auch Inhalte hinzufügen, indem Sie Inlinefluss-Inhaltselemente in der TextBox.Inlines-Eigenschaft wie folgt platzieren.

<TextBlock>Text can be <Bold>bold</Bold>, <Underline>underlined</Underline>, 
    <Italic>italic</Italic>, or a <Bold><Italic>combination</Italic></Bold>.</TextBlock>

Von der Inline-Klasse abgeleitete Elemente, z. B. Bold, Italic, Run, Span und LineBreak, ermöglichen unterschiedliche Formatierungen für verschiedene Teile des Texts. Weitere Informationen finden Sie im Abschnitt "Formatierungstext ". Mit dem Inlinelinkelement können Sie Ihrem Text einen Link hinzufügen. Die Verwendung von Inlines deaktiviert jedoch auch das rendern von schnellem Pfadtext, das im nächsten Abschnitt erläutert wird.

Überlegungen zur Leistung

Wann immer möglich, verwendet XAML einen effizienteren Codepfad zum Layouttext. Dieser schnelle Pfad verringert die Gesamtspeichernutzung und reduziert die CPU-Zeit erheblich, um Textmessung und Anordnung zu erledigen. Dieser schnelle Pfad gilt nur für TextBlock, daher sollte er bei Möglichkeit über RichTextBlock bevorzugt werden.

Bestimmte Bedingungen erfordern TextBlock, um auf einen funktionsreicheren und CPU-intensiven Codepfad für das Textrendering zurückzugreifen. Um das Rendern von Text auf dem schnellen Pfad beizubehalten, achten Sie beim Festlegen der hier aufgelisteten Eigenschaften darauf, diese Richtlinien zu befolgen.

  • Text: Die wichtigste Bedingung ist, dass der schnelle Pfad nur verwendet wird, wenn Sie Text festlegen, indem Sie die Text-Eigenschaft explizit festlegen, entweder in XAML oder im Code (wie in den vorherigen Beispielen gezeigt). Beim Festlegen des Texts über die Inlines-Sammlung von TextBlock (z. B. <TextBlock>Inline text</TextBlock>) wird der schnelle Pfad aufgrund der potenziellen Komplexität mehrerer Formate deaktiviert.
  • CharacterSpacing: Nur der Standardwert von 0 ist schneller Pfad.
  • TextTrimming: Nur die Werte "None", "CharacterEllipsis" und "WordEllipsis " sind ein schneller Pfad. Der Clip-Wert deaktiviert den schnellen Pfad.

Hinweis Vor Windows 10, Version 1607, wirken sich auch zusätzliche Eigenschaften auf den schnellen Pfad aus. Wenn Ihre App in einer früheren Version von Windows ausgeführt wird, führen diese Bedingungen auch dazu, dass Der Text auf dem langsamen Pfad gerendert wird. Weitere Informationen zu Versionen finden Sie unter Versionsadaptiver Code.

  • Typografie: Nur die Standardwerte für die verschiedenen Typografieeigenschaften sind schneller Pfad.
  • LineStackingStrategy: Wenn LineHeight nicht 0 ist, deaktivieren die BaselineToBaseline - und MaxHeight-Werte den schnellen Pfad.
  • IsTextSelectionEnabled: Nur false ist schneller Pfad. Wenn Sie diese Eigenschaft auf "true " festlegen, wird der schnelle Pfad deaktiviert.

Sie können die DebugSettings.IsTextPerformanceVisualizationEnabled-Eigenschaft beim Debuggen auf "true " festlegen, um zu bestimmen, ob Text schnelles Pfadrendering verwendet. Wenn diese Eigenschaft auf "true" festgelegt ist, wird der text, der sich auf dem schnellen Pfad befindet, in einer hellgrünen Farbe angezeigt.

Tipp Dieses Feature wird ausführlich in dieser Sitzung aus Build 2015- XAML-Leistung erläutert: Techniken für die Maximierung universeller Windows-App-Erfahrungen, die mit XAML erstellt wurden.

In der Regel legen Sie Debugeinstellungen in der OnLaunched-Methode außer Kraft auf der CodeBehind-Seite für "App.xaml" wie folgt fest.

protected override void OnLaunched(LaunchActivatedEventArgs e)
{
#if DEBUG
    if (System.Diagnostics.Debugger.IsAttached)
    {
        this.DebugSettings.IsTextPerformanceVisualizationEnabled = true;
    }
#endif

// ...

}

In diesem Beispiel wird der erste TextBlock mithilfe des schnellen Pfads gerendert, während die zweite nicht.

<StackPanel>
    <TextBlock Text="This text is on the fast path."/>
    <TextBlock>This text is NOT on the fast path.</TextBlock>
<StackPanel/>

Wenn Sie diesen XAML-Code im Debugmodus ausführen, wobei isTextPerformanceVisualizationEnabled auf "true" festgelegt ist, sieht das Ergebnis wie folgt aus.

Im Debugmodus gerenderter Text

Achtung

Die Farbe des Texts, der sich nicht auf dem schnellen Pfad befindet, wird nicht geändert. Wenn In Ihrer App Text mit der farbe als hellgrün angegeben ist, wird sie immer noch in hellgrün angezeigt, wenn sie sich auf dem langsameren Renderingpfad befindet. Verwechseln Sie text, der in der App auf Grün festgelegt ist, nicht mit Text, der sich auf dem schnellen Pfad befindet, und grün aufgrund der Debugeinstellungen.

Formatieren von Text

Obwohl die Text-Eigenschaft Nur-Text speichert, können Sie verschiedene Formatierungsoptionen auf das TextBlock-Steuerelement anwenden, um anzupassen, wie der Text in Ihrer App gerendert wird. Sie können Standardsteuerelementeigenschaften wie FontFamily, FontSize, FontStyle, Foreground und CharacterSpacing festlegen, um das Aussehen des Texts zu ändern. Sie können auch Inlinetextelemente und angefügte Typografieeigenschaften verwenden, um Den Text zu formatieren. Diese Optionen wirken sich nur darauf aus, wie textBlock den Text lokal anzeigt. Wenn Sie den Text also kopieren und in ein Rich-Text-Steuerelement einfügen, wird beispielsweise keine Formatierung angewendet.

Hinweis

Denken Sie daran, wie im vorherigen Abschnitt erwähnt, Inlinetextelemente und nicht standardmäßige Typografiewerte nicht auf dem schnellen Pfad gerendert werden.

Inlineelemente

Der Namespace "Microsoft.UI.Xaml.Documents " bietet eine Vielzahl von Inlinetextelementen, mit denen Sie Ihren Text formatieren können, z. B. "Fett", "Kursiv", "Ausführen", "Span" und "LineBreak".

Sie können eine Reihe von Zeichenfolgen in einem TextBlock anzeigen, wobei jede Zeichenfolge unterschiedliche Formatierungen aufweist. Dazu können Sie ein Run-Element verwenden, um jede Zeichenfolge mit ihrer Formatierung anzuzeigen und jedes Run-Element durch ein LineBreak-Element zu trennen.

Hier erfahren Sie, wie Sie mehrere unterschiedliche formatierte Textzeichenfolgen in einem TextBlock definieren, indem Sie Run-Objekte verwenden, die durch ein LineBreak getrennt sind.

<TextBlock FontFamily="Segoe UI" Width="400" Text="Sample text formatting runs">
    <LineBreak/>
    <Run Foreground="Gray" FontFamily="Segoe UI Light" FontSize="24">
        Segoe UI Light 24
    </Run>
    <LineBreak/>
    <Run Foreground="Teal" FontFamily="Georgia" FontSize="18" FontStyle="Italic">
        Georgia Italic 18
    </Run>
    <LineBreak/>
    <Run Foreground="Black" FontFamily="Arial" FontSize="14" FontWeight="Bold">
        Arial Bold 14
    </Run>
</TextBlock>

Dies ist das Ergebnis.

Text, der mit Ausführungselementen formatiert ist

Typografie

Die angefügten Eigenschaften der Typografieklasse bieten Zugriff auf eine Reihe von Microsoft OpenType-Typografieeigenschaften. Sie können diese angefügten Eigenschaften entweder für den TextBlock oder für einzelne Inlinetextelemente festlegen. Diese Beispiele zeigen beide.

<TextBlock Text="Hello, world!"
           Typography.Capitals="SmallCaps"
           Typography.StylisticSet4="True"/>

TextBlock textBlock1 = new TextBlock();
textBlock1.Text = "Hello, world!";
Typography.SetCapitals(textBlock1, FontCapitals.SmallCaps);
Typography.SetStylisticSet4(textBlock1, true);

<TextBlock>12 x <Run Typography.Fraction="Slashed">1/3</Run> = 4.</TextBlock>

Beispielcode herunterladen