TextChild 控件模式

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

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

screen shot showing text containing an embedded image and a hyperlink

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

screen shot showing inspect reporting a sample ui automation element tree

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

实现准则和约定

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

ITextChildProvider 的必需成员

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

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

 

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

概念性