ITextRangeProvider：：MoveEndpointByUnit 方法（uiautomationcore.h）
將文字範圍的一個端點移至檔範圍內的指定 TextUnit 單位數目。
語法
HRESULT MoveEndpointByUnit(
[in] TextPatternRangeEndpoint endpoint,
[in] TextUnit unit,
[in] int count,
[out, retval] int *pRetVal
);
參數
[in] endpoint
類型：TextPatternRangeEndpoint
要移動的端點。
[in] unit
類型：TextUnit
文字單位的類型，例如字元、文字、段落等等。
[in] count
類型：int
要移動的單位數目。 正值會將端點向前移動。 負值向後移動。 值為 0 沒有作用。
[out, retval] pRetVal
類型：int*
接收實際移動的單位數目，如果移動端點會進入檔的開頭或結尾，則此數目可能會小於所要求的數位。
傳回值
類型：HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
言論
端點 會依指定往前或向後移動至下一個可用的單位界限。 如果原始 端點 位於指定文字單位的界限，則 端點 會移至下一個可用的文字單位界限，如下圖所示。
如果移動的 端點 跨越相同文字範圍的另一個 端點，另一個 端點 也會移動，導致變質範圍，並確保 端點 的正確順序（也就是說，開始一律小於或等於結尾）。
如果控件不支援指定的文字單位，ITextRangeProvider：：MoveEndpointByUnit 取代下一個支援的文字單位。
訂單，從最小單位到最大，列在這裡。
- 字元
- 格式
- Word
- 行
- 段落
- 頁面
- 檔
單位TextUnit::Format 時 範圍行為
TextUnit::Format 做為 單位， 值會定位文字範圍的界限，以根據範圍內的文字共用文字屬性（格式）來展開或移動範圍。 不過，使用格式文字單位不應該移動或展開內嵌物件界限之間的文字範圍，例如影像或超連結。 如需詳細資訊，請參閱 UI 自動化文字單位 或 Text 和 TextRange 控制項模式。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | uiautomationcore.h （包括 UIAutomation.h） |
另請參閱
概念
參考