TextElement 類別

定義

命名空間:

Microsoft.UI.Xaml.Documents

抽象類別，做為同時抽象 區塊 和 內嵌 類別的基類。 TextElement 支援 XAML 文字物件模型相關類別的常見 API，例如控制文字大小、字型系列等的屬性。

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
• FontStretch
• 前景

藉由設定 TextElement 屬性，您可以將通用文字格式屬性套用至區塊和內嵌中的文字。 另外還有其他方法來格式化文字，但 TextElement 並不直接支援這些格式。 相反地，您可以使用 Typography 類別的附加屬性。 印刷樣式 附加屬性通常支援進階印刷樣式功能或慣例，例如存取字型層級上定義的印刷樣式功能，而並非所有字型都支援。 例如，您可以將 Typography.Variants 設定為任何文字區塊或內嵌的附加屬性，這會影響您所選擇在特定字型上設定 FontFamily 時所啟用的字型變體行為。

TextElement 原本不會定義 XAML 視覺化樹狀結構的連接點。 換句話說，TextElement 會定義該文字內的文字和文字物件模型，但尚未在 UI 中啟用該文字的顯示。 因此，您必須使用 UIElement 子系的其中一個控制項或元素，而且可以連接到 XAML 樹狀結構，以及應用程式視窗的根視覺效果。 Windows 執行階段中有兩個這類元素：

• TextBlock：僅支援內嵌的文字物件模型及其 Inlines 集合。
• RichTextBlock：支援區塊文字物件模型及其 Blocks 集合。 區塊可以包含區塊和內嵌。

注意

PasswordBox、 RichEditBox 和 TextBox 不支援以 TextElement 為基礎的文字物件模型。 RichEditBox 可透過 ITextDocument 介面，以程式設計方式存取不同的文字物件模型。

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。 區塊 和 內嵌 都是被視為基類， (您通常不會在 XAML) 中看到 <Block> 標記，而且主要存在於階層中，主要是做為其他實際文字元素的父類別。 例如， Block 是 Paragraph的父類別。 如需如何使用區塊和內嵌元素的詳細資訊，請參閱 文字區塊。

屬性

AccessKey	取得或設定這個專案的存取索引鍵。
AccessKeyProperty	識別 AccessKey 相依性屬性。
AccessKeyScopeOwner	取得或設定提供這個專案存取索引鍵範圍的來源專案，即使它不在來源專案的視覺化樹狀結構中也一樣。
AccessKeyScopeOwnerProperty	識別 AccessKeyScopeOwner 相依性屬性。
AllowFocusOnInteraction	取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。
AllowFocusOnInteractionProperty	識別 AllowFocusOnInteraction 相依性屬性。
CharacterSpacing	取得或設定字元之間的統一間距，單位為 em 的 1/1000。
CharacterSpacingProperty	識別 CharacterSpacing 相依性屬性。
ContentEnd	取得 TextPointer ，表示 專案中內容的結尾。
ContentStart	取得 TextPointer ，表示 元素中內容的開頭。
Dispatcher	一律會在Windows 應用程式 SDK應用程式中傳 null 回。 請改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式碼是由非 UI 執行緒起始，也可以存取 DependencyObject UI 執行緒上的 設備。 (繼承來源 DependencyObject)
ElementEnd	取得 TextPointer ，表示緊接在專案結尾之後的位置。
ElementStart	取得 TextPointer ，表示元素開頭之前的位置。
ExitDisplayModeOnAccessKeyInvoked	取得或設定值，這個值會指定叫用存取金鑰時，是否關閉存取金鑰顯示。
ExitDisplayModeOnAccessKeyInvokedProperty	識別 ExitDisplayModeOnAccessKeyInvoked 相依性屬性。
FontFamily	取得或設定項目內容慣用的最上層字型家族。
FontFamilyProperty	識別 FontFamily 相 依性屬性。
FontSize	取得或設定項目內容的字型大小。
FontSizeProperty	識別 FontSize 相依性屬性。
FontStretch	取得或設定要選取之系列中字型的字元寬度。
FontStretchProperty	識別 FontStretch 相依性屬性。
FontStyle	取得或設定這個專案中內容的字型樣式。
FontStyleProperty	識別 FontStyle 相依性屬性。
FontWeight	取得或設定要從此元素內容之字型系列中選取的最上層字型粗細。
FontWeightProperty	識別 FontWeight 相依性屬性。
Foreground	取得或設定要套用至這個專案中內容的 Brush 。
ForegroundProperty	識別 前景 相依性屬性。
IsAccessKeyScope	取得或設定值，這個值表示專案是否定義自己的便捷鍵範圍。
IsAccessKeyScopeProperty	識別 IsAccessKeyScope 相依性屬性。
IsTextScaleFactorEnabled	取得或設定是否啟用自動放大文字，以反映系統文字大小設定。
IsTextScaleFactorEnabledProperty	識別 IsTextScaleFactorEnabled 相依性屬性。
KeyTipHorizontalOffset	取得或設定值，這個值表示相對於文字專案放置按鍵提示的左邊或右邊。
KeyTipHorizontalOffsetProperty	識別 KeyTipHorizontalOffset 相依性屬性。
KeyTipPlacementMode	取得或設定值，這個值表示 KeyTip 相對於文字元素放置的位置。
KeyTipPlacementModeProperty	識別 KeyTipPlacementMode 相依性屬性。
KeyTipVerticalOffset	取得或設定值，這個值表示相對於文字元素放置按鍵提示的上下距離。
KeyTipVerticalOffsetProperty	識別 KeyTipVerticalOffset 相依性屬性。
Language	取得或設定適用于 TextElement的當地語系化/全球化語言資訊。
LanguageProperty	識別 語言 相依性屬性。
Name	取得或設定 物件的唯一識別。 名稱只能從 XAML 的初始剖析中設定。
TextDecorations	取得或設定值，這個值表示套用至文字的裝飾。
TextDecorationsProperty	識別 TextDecorations 相依性屬性。
XamlRoot	取得或設定正在檢視這個專案的 XamlRoot。

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
FindName(String)	藉由參考物件的 x：Name 或 Name 屬性值，擷取物件模型/執行時間物件圖形中的物件。
GetAnimationBaseValue(DependencyProperty)	傳回為相依性屬性建立的任何基底值，如果動畫未使用中，則適用此屬性。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
OnDisconnectVisualChildren()	覆寫這個方法，以實作從類別特定內容或子屬性移除專案時，配置和邏輯的行為方式。
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	設定 DependencyObject上相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)

事件

AccessKeyDisplayDismissed	發生于便捷鍵順序完成以通知控制項應該隱藏便捷鍵視覺效果時。
AccessKeyDisplayRequested	發生于啟動便捷鍵順序以通知控制項應該顯示便捷鍵視覺效果時。
AccessKeyInvoked	發生于使用者完成存取金鑰序列以通知專案應該叫用存取金鑰動作時。

另請參閱

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