ITextRange：：EndOf 方法 (tom.h)

  • 發行項

將此範圍的結尾移至範圍中最後一個重疊 單位 的結尾。

語法

HRESULT EndOf(
  long Unit,
  long Extend,
  long *pDelta
);

參數

Unit

類型： long

要使用的單位。 默認值： tomWord。 如需其他 Unit 值的清單，請參閱 ITextRange 下的討論。

Extend

類型： long

範圍移動結束方式的指標。 它可以是下列其中一項。

0 或 tomMove 移動插入點，將非產生範圍折疊至原始範圍的結尾。 此為預設值。
1 (或 tomExtend) 將 End 移至重迭 單位的結尾。 不會移動 Start。

pDelta

類型： long*

End 過去行動的字元計數。 指標的值可以是 Null。 傳回時， pDelta 的值是插入點或 End 移動的字元數，如果折疊至專案 End，則會 加上 1。 如果範圍包含最後的CR (歸位字元) (在本文結尾) 和Extend = tomMove，則 pDelta 會設定為 –1，表示折迭發生在範圍結尾 (，因為插入點不能存在於最終CR) 之外。

傳回值

類型： HRESULT

方法會傳回 HRESULT 值。 如果方法成功，則會傳回 S_OK。 如果方法失敗，它會傳回下列其中一個錯誤碼。 如需 COM 錯誤碼的詳細資訊，請參閱 COM 中的錯誤處理。

傳回碼 Description
E_NOTIMPL
 不支持單位。
S_FALSE
 因其他原因而失敗。

備註

為了比較， ITextRange：：StartOf 方法會將範圍結尾移至範圍中第一個重疊 單位 的開頭。 請注意， ITextRange：：StartOf 和 ITextRange：：EndOf 方法與 HomeKey 和 EndKey 方法不同，後者會從使用中端延伸，而 ITextRange：：StartOf 會從 Start 延伸，而 ITextRange：：EndOf 則從 End 延伸。 如果範圍是 Units 之間的界限插入點， ITextRange：：EndOf 不會變更 End。 特別是，呼叫 ITextRange：：EndOf (tomCharacter， *， *， *) 不會變更 End，但本文開頭的插入點除外。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 tom.h
Dll Msftedit.dll

另請參閱

概念

EndKey

HomeKey

ITextRange

參考

StartOf

文字物件模型