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