ITextRangeProvider.Move(TextUnit, Int32) 方法

public:
 int Move(System::Windows::Automation::Text::TextUnit unit, int count);

public int Move(System.Windows.Automation.Text.TextUnit unit, int count);

abstract member Move : System.Windows.Automation.Text.TextUnit * int -> int

Public Function Move (unit As TextUnit, count As Integer) As Integer

參數

傳回

實際移動的單位數量。 如果任一新的文字範圍端點大於或小於端 DocumentRange 點，這個數值可能會小於請求的數量。

備註

當需要遍歷文字範圍的內容時，在幕後需要一系列步驟，才能讓 Move 方法順利執行。

1. 文字範圍已被正規化；意味著，文字範圍會折疊為Start 端點的退化範圍，使End 端點變得多餘。 此步驟是為了消除文字範圍跨 unit 越邊界的情況中的歧義;例如，「{The U}RL https://www.microsoft.com/ is embedded in text」中，其中「{」和「}」為文字範圍的端點。

2. 產生的範圍會移動至 DocumentRange 中，向後到達所要求 unit 界限的開頭。

3. 範圍會依要求的界限數目DocumentRange往前或向後unit移動。

4. 然後，範圍會從退化的範圍狀態通過將 End 端點移動到一個要求的 unit 邊界來進行擴展。

調整範圍 透過移動與擴展調整範圍文字範圍如何調整 Move（） 與 ExpandToEnclosingUnit（） 的範例

在 UI 自動化樹狀結構的控制項檢視和內容檢視 (例如超連結或表格儲存格) 中，文字容器和內嵌物件的文字內容 (或內部文字) 會公開為單一連續的文字資料流； 物件界限會被忽略。

由由包含嵌入物件及其範圍範圍的文字串流範例

Move 尊重隱藏與可見文字。

Move若給定TextUnit未被控制組支持，則 讓位給出的下一個較大TextUnit支持者。

從最小到最大單位的順序如下所示。

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document

文字本身沒有任何改變，文字範圍只是跨越了文本的不同部分。