TextChild 控件模式

介绍实现 ITextChildProvider 的准则和约定,包括有关属性和方法的信息。 TextChild 控件模式用于访问支持 Text 控件模式的元素最接近的上级。

例如,假设文档中的文本包含嵌入的图像和超链接,如下图所示。

显示包含嵌入图像和超链接的文本的屏幕截图

如果使用 Microsoft UI 自动化 工具来检查此文档内容的UI 自动化树,它可能会显示一个文档元素,其中包含一个表示图像的子元素,另一个子元素表示超链接。 例如:

显示检查报告示例 ui 自动化元素树的屏幕截图

通常,前面示例中的文档元素支持 Text 控件模式,但文档元素的两个子元素不支持。 如果UI 自动化客户端应用程序引用了图像元素或超链接元素,则客户端可以使用 TextChild 控件模式作为访问由包含文档元素公开的 Textcontrol 模式的便捷方法。

实现准则和约定

实现 ITextChildProvider 接口时,请注意以下准则和约定:

ITextChildProvider 的必需成员

实现 ITextChildProvider 接口需要这些属性和方法。

必需的成员 成员类型 说明
TextContainer 属性
TextRange 属性

 

没有与此控件模式关联的方法或事件。

概念性