TextElement Klasse

Referenz

Definition

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

Microsoft.UI.Xaml.Documents.Inline

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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:

TextBlock: Unterstützt ein Textobjektmodell von Inlines nur mit seiner Inlinesauflistung .
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 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ück`null`. 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: