TextChild 控件模式
介绍实现 ITextChildProvider的准则和约定，包括有关属性和方法的信息。 TextChild 控件模式用于访问支持 Text 控件模式的元素最接近的上级。
例如，假设文档中的文本包含嵌入的图像和超链接，如下图所示。
显示包含嵌入图像和超链接屏幕截图
如果使用 Microsoft UI 自动化工具检查此文档内容的 UI 自动化树，则它可能会显示一个文档元素，其中包含一个表示图像的子元素，以及另一个表示超链接的子元素。 例如：
显示检查报告示例 ui 自动化元素树屏幕截图
通常，前面的示例中的文档元素支持 文本 控件模式，但文档元素的两个子元素不支持。 如果 UI 自动化客户端应用程序引用图像元素或超链接元素，则客户端可以使用 TextChild 控件模式作为访问包含文档元素公开的 Textcontrol 模式的便捷方法。
实施准则和约定
实现 ITextChildProvider 接口时，请注意以下准则和约定：
- ITextChildProvider：：TextContainer 属性应指定支持 ITextProvider 接口的最接近的上级元素，无论上级链中的元素是否也支持 ITextProvider。
- 元素不应同时支持ITextProvider 和 ITextChildProvider** 接口。
- 实现 ITextChildProvider 的元素必须是实现 ITextProvider的元素的子级或子代。 此元素也不需要实现 文本控件模式。
- ITextChildProvider：：TextRange 属性应指定与包含文本提供程序元素在其 ITextProvider：：RangeFromChild 函数作为封闭子元素调用时返回的文本范围相同。
ITextChildProvider 的必需成员
实现 ITextChildProvider 接口需要这些属性和方法。
| 必需成员 | 成员类型 | 笔记 |
|---|---|---|
| TextContainer | 财产 | 没有 |
| TextRange | 财产 | 没有 |
此控件模式没有关联的方法或事件。
相关主题
概念