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