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：仅支持内联文本对象模型及其 Inlines 集合。
- RichTextBlock：支持块文本对象模型及其 Blocks 集合。 块可以包含块和内联。
注意
PasswordBox、 RichEditBox 和 TextBox 不支持基于 TextElement 的文本对象模型。 RichEditBox 支持通过 ITextDocument 接口以编程方式访问不同的文本对象模型。
TextElement 定义 API，该 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 的父类。 有关如何使用块元素和内联元素的详细信息，请参阅 快速入门：显示文本。
版本历史记录
| 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 |
当用户完成访问键序列以通知元素应调用访问键操作时发生。 |