TextElement 類別

  • 參考

定義

命名空間:
Windows.UI.Xaml.Documents
編輯

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

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
繼承
Object Platform::Object IInspectable DependencyObject TextElement
衍生
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

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

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

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

  • TextBlock：僅支援內嵌的文字物件模型及其 內嵌 集合。
  • 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的父類別。 如需如何使用區塊和內嵌元素的詳細資訊，請參閱 快速入門：顯示文字。

版本歷程記錄

Windows 版本 SDK 版本 新增值
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

屬性

AccessKey

取得或設定這個專案的存取索引鍵。
AccessKeyProperty

識別 AccessKey 相依性屬性。
AccessKeyScopeOwner

取得或設定來源專案，這個元素會提供這個專案的存取索引鍵範圍，即使它不在來源專案的視覺化樹狀結構中也一樣。
AccessKeyScopeOwnerProperty

識別 AccessKeyScopeOwner 相依性屬性。
AllowFocusOnInteraction

取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。
AllowFocusOnInteractionProperty

識別 AllowFocusOnInteraction 相依性屬性。
CharacterSpacing

取得或設定字元之間的統一間距，單位為 em 的 1/1000。
CharacterSpacingProperty

識別 CharacterSpacing 相依性屬性。
ContentEnd

取得 TextPointer ，表示 專案中內容的結尾。
ContentStart

取得 TextPointer ，表示 專案中內容的開頭。
Dispatcher

取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 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

識別 Language 相依性屬性。
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

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

適用於

另請參閱