TextElement Klasse

Definition

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

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

Windows-Anforderungen

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

Hinweise

Die verschiedenen von TextElement definierten Eigenschaften unterstützen eine allgemeine API für Klassen, die am XAML-Textobjektmodell beteiligt sind. Im Folgenden finden 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 Schriftartebene definiert sind und nicht unbedingt von allen Schriftarten unterstützt werden. Sie können beispielsweise Typography.Variants als angefügte Eigenschaft für einen beliebigen Textblock oder inline festlegen. Dies würde das Verhalten von Schriftartvarianten beeinflussen, das durch die bestimmte Schriftart aktiviert wird, die Sie für das Festlegen von FontFamily für dieses Textelement ausgewählt haben.

TextElement definiert keinen Verbindungspunkt mit einer visuellen XAML-Struktur. Mit anderen Worten definiert ein TextElement text- und textobjektmodell innerhalb dieses Texts, ermöglicht 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. Die Windows-Runtime enthält zwei solche Elemente:

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 xaml analysiert wurde. Insbesondere TextElement implementiert Name und Sprache, die parallele Eigenschaften desselben Namens in FrameworkElement. TextElement implementiert auch FindName (eine Hilfsmethode zum Suchen von Objekten zur Laufzeit basierend darauf, wie Name in der anfänglichen XAML 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, deren Eigenschaftsbezeichner ebenfalls durch TextElement definiert wird. Weitere Informationen dazu, was Abhängigkeitseigenschaften aktivieren, finden Sie unter Übersicht über Abhängigkeitseigenschaften.

Abgeleitete TextElement-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 die übergeordnete Klasse anderer praktischer Textelemente. Beispielsweise ist Block die übergeordnete Klasse von Paragraph. Weitere Informationen zur Verwendung von Block- und Inlineelementen finden Sie unter Schnellstart: Anzeigen von Text.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1607 14393 AccessKey
1607 14393 AllowFocusOnInteraction
1607 14393 ExitDisplayModeOnAccessKeyInvoked
1703 15063 AccessKeyDisplayDismissed
1703 15063 AccessKeyDisplayRequested
1703 15063 AccessKeyInvoked
1703 15063 AccessKeyScopeOwner
1703 15063 IsAccessKeyScope
1703 15063 KeyTipHorizontalOffset
1703 15063 KeyTipPlacementMode
1703 15063 KeyTipVerticalOffset
1703 15063 Textdecorations
1903 18362 XamlRoot

Eigenschaften

AccessKey

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

AccessKeyProperty

Identifiziert die AccessKey-Abhängigkeitseigenschaft .

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 dem Element interagiert, oder legt diesen fest.

AllowFocusOnInteractionProperty

Identifiziert die AllowFocusOnInteraction-Abhängigkeitseigenschaft .

CharacterSpacing

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

CharacterSpacingProperty

Identifiziert die CharacterSpacing-Abhängigkeitseigenschaft .

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

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.

ElementStart

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

ExitDisplayModeOnAccessKeyInvoked

Ruft einen Wert ab, der angibt, ob die Anzeige der Zugriffsschlüssel geschlossen wird, wenn ein Zugriffsschlüssel aufgerufen wird, oder legt diesen fest.

ExitDisplayModeOnAccessKeyInvokedProperty

Identifiziert die ExitDisplayModeOnAccessKeyInvoked-Abhängigkeitseigenschaft .

FontFamily

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

FontFamilyProperty

Identifiziert die FontFamily-Abhängigkeitseigenschaft .

FontSize

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

FontSizeProperty

Identifiziert die FontSize-Abhängigkeitseigenschaft .

FontStretch

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

FontStretchProperty

Identifiziert die FontStretch-Abhängigkeitseigenschaft .

FontStyle

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

FontStyleProperty

Identifiziert die FontStyle-Abhängigkeitseigenschaft .

FontWeight

Ruft die Schriftstärke der obersten Ebene ab, die aus der Schriftartfamilie 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

Identifiziert die IsTextScaleFactorEnabled-Abhängigkeitseigenschaft .

KeyTipHorizontalOffset

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

KeyTipHorizontalOffsetProperty

Identifiziert die KeyTipHorizontalOffset-Abhängigkeitseigenschaft .

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 Bezug auf das Textelement platziert wird, oder legt diesen fest.

KeyTipVerticalOffsetProperty

Gibt die KeyTipVerticalOffset-Abhängigkeitseigenschaft an.

Language

Ruft Lokalisierungs-/Globalisierungssprachinformationen 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

Identifiziert die TextDecorations-Abhängigkeitseigenschaft .

XamlRoot

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

Methoden

ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Abhängigkeitseigenschaft.

(Geerbt von DependencyObject)
FindName(String)

Ruft ein Objekt im Objektmodell-/Laufzeitobjektgraphen 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 eingerichtet wurde, der 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 durch Aufrufen von RegisterPropertyChangedCallback registriert wurde.

(Geerbt von DependencyObject)

Ereignisse

AccessKeyDisplayDismissed

Tritt auf, wenn die Zugriffstastensequenz abgeschlossen ist, um Steuerelemente zu benachrichtigen, dass sie Visuals für Zugriffsschlüssel ausblenden sollen.

AccessKeyDisplayRequested

Tritt auf, wenn die Zugriffstastensequenz gestartet wird, um Steuerelemente zu benachrichtigen, dass sie Visuals für Zugriffsschlüssel anzeigen sollen.

AccessKeyInvoked

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

Gilt für:

Weitere Informationen