TextElement Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml.Documents

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.

Bearbeiten

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: Windows.UI.Xaml.Documents.Block

Windows.UI.Xaml.Documents.Inline

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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:

TextBlock: Unterstützt ein Textobjektmodell von Inlines nur mit seiner Inlines-Auflistung .
RichTextBlock: Unterstützt ein Blocktextobjektmodell mit seiner Blocks-Auflistung . Die Blöcke können Blöcke und Inlines enthalten.

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: