Freigeben über


TextElement Klasse

Definition

Eine abstrakte Klasse, die als Basisklasse für die ebenfalls abstrakten Block - und Inline-Klassen verwendet wird. TextElement unterstützt allgemeine API für Klassen, die am XAML-Textobjektmodell beteiligt sind, z. B. Eigenschaften, die Textgröße, Schriftartfamilien usw. steuern.

public ref class TextElement : DependencyObject
/// [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 TextElement : DependencyObject
[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 TextElement : DependencyObject
Public Class TextElement
Inherits DependencyObject
Vererbung
Object Platform::Object IInspectable DependencyObject TextElement
Abgeleitet
Attribute

Hinweise

Die verschiedenen von TextElement definierten Eigenschaften unterstützen eine allgemeine API für Klassen, die am XAML-Textobjektmodell beteiligt sind. Hier sehen Sie eine Liste der am häufigsten verwendeten Eigenschaften:

Durch Festlegen von TextElement-Eigenschaften können Sie allgemeine Textformatierungseigenschaften auf Text anwenden, sowohl in Blöcken als auch in Inlines. Es gibt auch zusätzliche Möglichkeiten zum Formatieren von Text, die jedoch nicht direkt von TextElement unterstützt werden. Stattdessen können Sie die angefügten Eigenschaften der Typography-Klasse verwenden. Typografie angefügte Eigenschaften unterstützen in der Regel erweiterte typografische Features oder Konventionen, z. B. den Zugriff auf typografische Features, die auf Der Schriftartebene definiert sind und die nicht unbedingt von allen Schriftarten unterstützt werden. Beispielsweise könnten Sie Typography.Variants als angefügte Eigenschaft für jeden Textblock oder inline festlegen. Dies würde das Verhalten von Schriftartvarianten beeinflussen, die durch die bestimmte Schriftart aktiviert ist, die Sie für das Festlegen von FontFamily für dieses Textelement ausgewählt haben.

TextElement definiert keinen Verbindungspunkt mit einer visuellen XAML-Struktur. Anders ausgedrückt: Ein TextElement definiert Text- und Textobjektmodell innerhalb dieses Texts, aktiviert aber noch nicht die Anzeige dieses Texts innerhalb einer Benutzeroberfläche. Dazu müssen Sie eines der Steuerelemente oder Elemente verwenden, die nachfolger von UIElement sind und mit der XAML-Struktur und dem Stammvisual Ihres App-Fensters verbunden werden können. Es gibt zwei solche Elemente in der Windows-Runtime:

Hinweis

PasswordBox, RichEditBox und TextBox unterstützen kein Textobjektmodell, das auf TextElement basiert. RichEditBox ermöglicht den programmgesteuerten Zugriff auf ein anderes Textobjektmodell über die ITextDocument-Schnittstelle .

TextElement definiert eine API, die das Untersuchen des Textobjektmodells als Programmierobjekte unterstützt, nachdem der XAML-Code analysiert wurde. Insbesondere TextElement implementiert Name und Sprache, die parallele Eigenschaften desselben Namens in FrameworkElement. TextElement implementiert auch FindName (eine Hilfsprogrammmethode zum Suchen von Objekten zur Laufzeit basierend darauf, wie Name im anfänglichen XAML-Code festgelegt wurde) und OnDisconnectVisualChildren (für erweiterte Szenarien und Designerunterstützung).

TextElement verfügt über vier Eigenschaften, die den Zugriff auf TextPointer-Objekte innerhalb von Text ermöglichen. Diese Eigenschaften sind: ContentStart, ContentEnd, ElementStart, ElementEnd. Ein Windows-Runtime TextPointer-Objekt bietet Ihnen einen Einstiegspunkt für die Durchquerung von Inhalten. Weitere Informationen finden Sie unter TextPointer.

TextElement ist eine von DependencyObject abgeleitete Klasse. Das bedeutet, dass Abhängigkeitseigenschaften definiert werden können, und jede der Lese-/Schreibeigenschaften von TextElement ist eine Abhängigkeitseigenschaft, wobei derEn Eigenschaftsbezeichner auch durch TextElement definiert wird. Weitere Informationen zur Aktivierung von Abhängigkeitseigenschaften finden Sie unter Übersicht über Abhängigkeitseigenschaften.

Von TextElement abgeleitete Klassen

TextElement ist die übergeordnete Klasse für zwei abgeleitete Klassen, die das Textobjektmodell in zwei Textverwendungskonventionen aufteilen: Block und Inline. Block und Inline gelten beide als Basisklassen (in XAML wird in der Regel kein Tag angezeigt <Block> ) und sind in der Hierarchie hauptsächlich als übergeordnete Klasse anderer praktischer Textelemente vorhanden. Block ist beispielsweise die übergeordnete Klasse von Paragraph. Weitere Informationen zur Verwendung von Block- und Inlineelementen finden Sie unter Textblock.

Eigenschaften

AccessKey

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

AccessKeyProperty

Gibt die AccessKey-Abhängigkeitseigenschaft an.

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.

AccessKeyScopeOwnerProperty

Identifiziert die AccessKeyScopeOwner-Abhängigkeitseigenschaft .

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.

AllowFocusOnInteractionProperty

Gibt die AllowFocusOnInteraction-Abhängigkeitseigenschaft an.

CharacterSpacing

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

CharacterSpacingProperty

Gibt die CharacterSpacing-Abhängigkeitseigenschaft an.

ContentEnd

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

ContentStart

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

Dispatcher

Gibt immer in einer Windows App SDK-App zurücknull. Verwenden Sie stattdessen DispatcherQueue .

(Geerbt von DependencyObject)
DispatcherQueue

Ruft den DispatcherQueue ab, dem dieses Objekt zugeordnet ist. Stellt DispatcherQueue eine Funktion dar, die auf den 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.

ElementStart

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

ExitDisplayModeOnAccessKeyInvoked

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

ExitDisplayModeOnAccessKeyInvokedProperty

Gibt die Abhängigkeitseigenschaft ExitDisplayModeOnAccessKeyInvoked an .

FontFamily

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

FontFamilyProperty

Gibt die FontFamily-Abhängigkeitseigenschaft an.

FontSize

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

FontSizeProperty

Gibt die FontSize-Abhängigkeitseigenschaft an.

FontStretch

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

FontStretchProperty

Gibt die FontStretch-Abhängigkeitseigenschaft an.

FontStyle

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

FontStyleProperty

Gibt die FontStyle-Abhängigkeitseigenschaft an.

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.

FontWeightProperty

Gibt die FontWeight-Abhängigkeitseigenschaft an.

Foreground

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

ForegroundProperty

Gibt die Vordergrundabhängigkeitseigenschaft an.

IsAccessKeyScope

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

IsAccessKeyScopeProperty

Identifiziert die IsAccessKeyScope-Abhängigkeitseigenschaft .

IsTextScaleFactorEnabled

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

IsTextScaleFactorEnabledProperty

Gibt die Abhängigkeitseigenschaft IsTextScaleFactorEnabled an.

KeyTipHorizontalOffset

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

KeyTipHorizontalOffsetProperty

Gibt die Abhängigkeitseigenschaft KeyTipHorizontalOffset an.

KeyTipPlacementMode

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

KeyTipPlacementModeProperty

Gibt die KeyTipPlacementMode-Abhängigkeitseigenschaft an.

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.

KeyTipVerticalOffsetProperty

Gibt die Abhängigkeitseigenschaft KeyTipVerticalOffset an.

Language

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

LanguageProperty

Gibt die Language-Abhängigkeitseigenschaft an.

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.

TextDecorations

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

TextDecorationsProperty

Gibt die Abhängigkeitseigenschaft TextDecorations an .

XamlRoot

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

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.

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.

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.

AccessKeyDisplayRequested

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

AccessKeyInvoked

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

Gilt für:

Weitere Informationen