共用方式為

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 端點，從變質範圍狀態展開。

Move & ExpandToEnclosingUnit
如何針對 Move() 和 ExpandToEnclosingUnit() 調整文字範圍的範例

注意

這些步驟是必要的，因為螢幕助讀程式通常會在插入點或任何虛擬游標位置讀出完整的單字、句子或整個段落。

ExpandToEnclosingUnit 會同時遵守隱藏和可見的文字。

ExpandToEnclosingUnit如果控件不支援指定的 TextUnit ，則會延遲至下一個最大TextUnit支援。

以下列出從最小單位到最大的順序。

適用於