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
衍生
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

備註

TextElement 所定義的各種屬性支援 XAML 文字物件模型相關類別的通用 API。 以下是最常使用的屬性清單：

藉由設定 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

發生于使用者完成存取金鑰序列以通知專案應該叫用存取金鑰動作時。

適用於

另請參閱