IUIAutomationTextRange：：MoveEndpointByUnit 方法 (uiautomationclient.h)

在文件範圍內，將文字範圍的一個端點移動指定的文字單元數。

語法

HRESULT MoveEndpointByUnit(
  [in]          TextPatternRangeEndpoint endpoint,
  [in]          TextUnit                 unit,
  [in]          int                      count,
  [out, retval] int                      *moved
);

參數

[in] endpoint

類型： TextPatternRangeEndpoint

值，指定要移動的端點 (開始或結束) 。

[in] unit

類型： TextUnit

值，指定移動的文字單位，例如行或段落。

[in] count

類型： int

要移動的單位數。 正計數會將端點向前移動。 負計數會向後移動。 計數為 0 沒有作用。

[out, retval] moved

類型： int*

接收實際行動的單位計數。 如果移動端點會進入檔的開頭或結尾，這個值可以小於所要求的數位。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

端點會依指定向前或向後移動至下一個可用的單位界限。 如果原始 端點 位於指定文字單位的界限， 則端點 會移至下一個可用的文字單位界限，如下圖所示。

如果移動的 端點 跨越相同文字範圍的其他 端點 ，也會移動另一個 端點 ，因而產生變質的範圍，並確保 端點 (的正確順序，也就是開始一律小於或等於結尾) 。

如果控件不支援指定的文字單位，MoveEndpointByUnit 最多可取代下一個支援的文字單位。

這裡列出從最小單位到最大單位的順序。

• 字元
• 格式
• Word
• 線條
• 段
• 頁面
• 文件

單位為 時的範圍行為TextUnit::Format

TextUnit::Format作為單位值，會將文字範圍的界限定位為根據共用文字屬性展開或移動範圍， (格式) 範圍內文字。 不過，使用格式文字單位不會移動或展開內嵌物件界限的文字範圍，例如影像或超連結。 如需詳細資訊，請參閱 使用者介面自動化 文字單元或文字內容的 使用者介面自動化 支援。

規格需求

需求	值
最低支援的用戶端	Windows 7、Windows Vista sp2 和 Platform Update for Windows Vista、Windows XP with SP3 和 Platform Update for Windows Vista [僅限桌面應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [僅限桌面應用程式]
目標平台	Windows
標頭	uiautomationclient.h (包含 UIAutomation.h)

另請參閱

IUIAutomationTextRange

使用者介面自動化 文字內容的支援