ITextRangeProvider::ExpandToEnclosingUnit 方法 (uiautomationcore.h)
按指定的文本单位规范化文本范围。 如果范围小于指定的单位,则扩大;如果范围长于指定单位,则缩短范围。
语法
HRESULT ExpandToEnclosingUnit(
[in] TextUnit unit
);
参数
[in] unit
类型: TextUnit
文本单位的类型,如字符、单词、段落等。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
客户端应用程序(如屏幕阅读器)使用此方法检索插入点或插入点位置处的完整单词、句子或段落。
尽管其名称为 ITextRangeProvider::ExpandToEnclosingUnit 方法不一定扩展文本范围。 相反,它通过移动终结点使文本范围包含指定的文本单位来“规范化”文本范围。 如果范围小于指定的单位,则扩大;如果范围长于指定单位,则缩短范围。 如果范围已经是指定单位的确切数量,则保持不变。 ExpandToEnclosingUnit 方法始终以一致的方式规范化文本范围至关重要:否则,文本单元的文本范围操作的其他方面将是不可预知的。 下图显示了 ExpandToEnclosingUnit 如何通过移动范围的终结点来规范化文本范围。
,如果控件不支持指定的文本单位,则默认为支持的下一个最大文本单位。 从最小单位到最大单位的顺序如下所示:- 字符
- 格式
- Word
- 线条
- Paragraph
- Page
- Document
单位为 时的范围行为TextUnit::Format
TextUnit::Format
作为 单位 值定位文本范围的边界,以基于共享文本属性 (格式) 范围内的文本扩展或移动范围。 但是,使用格式文本单元不应跨嵌入对象的边界(如图像或超链接)移动或扩展文本范围。 有关详细信息,请参阅 UI 自动化文本单元 或 文本和 TextRange 控件模式。
要求
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | uiautomationcore.h (包括 UIAutomation.h) |
请参阅
概念性
引用