Share via

ITextRangeProvider：：ExpandToEnclosingUnit 方法 (uiautomationcore.h)

  • 项目

按指定的文本单位规范化文本范围。 如果范围小于指定的单位，则扩大;如果范围长于指定单位，则缩短范围。

语法

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit unit
);

参数

[in] unit

类型： TextUnit

文本单位的类型，如字符、单词、段落等。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

客户端应用程序（如屏幕阅读器）使用此方法检索插入点或插入点位置处的完整单词、句子或段落。

尽管其名称为 ITextRangeProvider：：ExpandToEnclosingUnit 方法不一定扩展文本范围。 相反，它通过移动终结点使文本范围包含指定的文本单位来“规范化”文本范围。 如果范围小于指定的单位，则扩大;如果范围长于指定单位，则缩短范围。 如果范围已经是指定单位的确切数量，则保持不变。 ExpandToEnclosingUnit 方法始终以一致的方式规范化文本范围至关重要：否则，文本单元的文本范围操作的其他方面将是不可预知的。 下图显示了 ExpandToEnclosingUnit 如何通过移动范围的终结点来规范化文本范围。

显示调用 ExpandToEnclosingUnit ExpandToEnclosingUnit 之前和之后的终结点位置的关系图，如果控件不支持指定的文本单位，则默认为支持的下一个最大文本单位。 从最小单位到最大单位的顺序如下所示：
  • 字符
  • 格式
  • Word
  • 线条
  • Paragraph
  • Page
  • Document
ExpandToEnclosingUnit 同时遵循可见文本和隐藏文本。

单位为 时的范围行为TextUnit::Format

TextUnit::Format 作为 单位 值定位文本范围的边界，以基于共享文本属性 (格式) 范围内的文本扩展或移动范围。 但是，使用格式文本单元不应跨嵌入对象的边界（如图像或超链接）移动或扩展文本范围。 有关详细信息，请参阅 UI 自动化文本单元 或 文本和 TextRange 控件模式。

要求

   
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)

请参阅

概念性

ITextProvider

ITextRangeProvider

引用

Text 和 TextRange 控件模式

UI 自动化提供程序概述