通过

ITextRangeProvider.ExpandToEnclosingUnit(TextUnit) 方法

  • 参考

定义

命名空间:
System.Windows.Automation.Provider
程序集:
UIAutomationProvider.dll
程序集:
UIAutomationProvider.dll, UIAutomationTypes.dll
程序集:
UIAutomationTypes.dll

将文本范围扩展到指定的文本单位。

public:
 void ExpandToEnclosingUnit(System::Windows::Automation::Text::TextUnit unit);
public void ExpandToEnclosingUnit (System.Windows.Automation.Text.TextUnit unit);
abstract member ExpandToEnclosingUnit : System.Windows.Automation.Text.TextUnit -> unit
Public Sub ExpandToEnclosingUnit (unit As TextUnit)

参数

unit
TextUnit

文本单位。

注解

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

为了成功执行方法， Move 在后台涉及一系列步骤。

  1. 对文本范围进行了规范化。也就是说，已在 Start 终结点将文本范围折叠为退化范围，这使得 End 终结点成为多余。 若要在文本范围跨越 unit 边界的情况下消除歧义，必须执行此步骤;例如，“{The U}RL https://www.microsoft.com/ 嵌入文本”，其中“{”和“}”是文本范围终结点。

  2. 生成的范围在 DocumentRange 中向后移动到所请求的 unit 边界的开头。

  3. 范围在 DocumentRange 中向前或向后移动所请求的 unit 边界的数目。

  4. 然后通过将 End 终结点移动一个所请求的 unit 边界，范围从退化范围状态扩展开来。

通过移动 & ExpandToEnclosingUnit
如何针对 Move() 和 ExpandToEnclosingUnit() 调整文本范围的示例

注意

这些步骤是必需的，因为屏幕阅读器通常会在插入点或任何虚拟光标位置读出完整的单词、句子或整个段落。

ExpandToEnclosingUnit 尊重隐藏文本和可见文本。

ExpandToEnclosingUnit如果控件不支持给定TextUnit的 ，则 延迟到支持的下一个最大 TextUnit 。

下面列出了从最小单位到最大的订单。

适用于