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) |
请参阅
概念性
引用