TextElement 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
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 : DependencyObjectPublic Class TextElement
Inherits DependencyObject- 繼承
- 衍生
- 屬性
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 |
屬性
方法
| 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 |
發生于使用者完成存取金鑰序列以通知專案應該叫用存取金鑰動作時。 |