TextRange_ExpandToEnclosingUnit 函数 (uiautomationcoreapi.h)

注意此函数已弃用。客户端应用程序应改用 Microsoft UI 自动化组件对象模型 (COM) 接口。

将文本范围扩展到更大或更小的单位，例如 Character、Word、Line 或 Page。

语法

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

[in] hobj

类型： HUIATEXTRANGE

文本范围对象。

[in] unit

类型： TextUnit

提供程序必须将文本范围扩展到的单位。

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值。

如果范围已经是指定单位的整数，则它保持不变。

如果起始终结点不在 TextUnit 边界上，则会向后移动，直到它位于边界处。随后，如果结束终结点不在边界上，或者它与起始终结点位于同一边界，则结束终结点将向前移动，直到它位于边界处。

注意屏幕阅读器通常会在插入点或任何虚拟光标位置读出完整的单词、整个段落等。

TextRange_ExpandToEnclosingUnit 同时遵循隐藏文本和可见文本。 UI Automationclient 可以检查隐藏属性 (Text_IsHidden_Attribute_GUID) 文本可见性。

如果给定的 TextUnit 不受控件支持，则TextRange_ExpandToEnclosingUnit默认为下一个受支持的 TextUnit。