TextElement 類別

定義

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

繼承

Object Platform::Object IInspectable DependencyObject TextElement

衍生

Microsoft.UI.Xaml.Documents.Block

Microsoft.UI.Xaml.Documents.Inline

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

備註

TextElement 定義的各種屬性支援 XAML 文字物件模型中涉及類別的共通 API。 以下是最常用的房產清單：

• FontFamily
• FontSize
• 字體伸展
• Foreground

透過設定 TextElement 屬性，你可以將常見的文字格式屬性套用到文字上，無論是區塊形式還是內列格式。 還有其他格式化文字的方法，但 TextElement 並不直接支援這些。 你可以使用字 體 類別附帶的屬性。 字體附加屬性通常支援進階的字體特徵或慣例，例如存取字型層級定義的字體特徵，這些功能不一定被所有字型支援。 例如，你可以將 Typography.Variants 設定為任何文字區塊或內嵌字體的附加屬性，這會影響你選擇的字型在該文字元素設定 FontFamily 時啟用的 font-variants 行為。

TextElement 本身並不定義連接到 XAML 視覺樹的連接點。 換句話說，TextElement 定義了該文字中的文字及其物件模型，但尚未能在 UI 中顯示該文字。 為此，你需要使用 UIElement 的後代控制項或元素，這些元素可以連接到XAML樹和你應用程式視窗的根視覺化。 Windows 執行階段 中有兩個此類元素：

• TextBlock：僅支援內嵌文字物件模型，並搭配其 Inline 集合。
• RichTextBlock：支援區塊文字物件模型及其區 塊 集合。 這些區塊可以包含區塊和內嵌區塊。

TextElement 定義了 API，支援在解析 XAML 後，將文字物件模型視為程式物件來檢視。 特別是 TextElement 實作 了 Name 和 Language，這兩者在 FrameworkElement 上平行呈現同名屬性。 TextElement 也實作 了 FindName （一種基於初始 XAML 中 Name 設定方式，可在執行時尋找物件的工具方法）以及 OnDisconnectVisualChildren （用於進階情境與設計器支援）。

TextElement 有四個屬性，提供從文字內部存取 TextPointer 物件的存取。 這些屬性包括： ContentStart、 ContentEnd、 ElementStart、 ElementEnd。 Windows 執行階段 的 TextPointer 物件提供內容遍歷的入口點。 更多資訊請參見 TextPointer。

TextElement 是一個源自 DependencyObject 的類別。 這表示它可以定義相依屬性，而 TextElement 的每個讀寫屬性都是相依屬性，其屬性識別碼也由 TextElement 定義。 關於依賴屬性啟用的更多資訊，請參閱 依賴屬性概述。

TextElement 衍生類別

TextElement 是兩個派生類別的父類別，將文字物件模型拆分為兩種文字使用慣例： Block 與 Inline。 Block 和 Inline 都被視為基底類別（XAML 裡通常不會看到標籤 <Block> ），它們主要存在於階層結構中，是為了作為其他實用文本元素的父類別。 例如， Block 是 Paragraph 的父類別。 欲了解更多如何使用區塊與內嵌元素，請參見 文字區塊。

另請參閱

• DependencyObject
• Block
• Inline
• Typography
• 文字區塊