ITextRange::SetEnd 方法 (tom.h)

設定範圍的結束位置。

語法

HRESULT SetEnd(
  long cpLim
);

參數

cpLim

類型: long

新的結束位置。

傳回值

類型: HRESULT

方法會傳回 HRESULT 值。 如果方法成功,它會 傳回S_OK。 如果方法失敗,它會傳回S_FALSE。

備註

如果新的結束位置小於開始位置,這個方法也會將開始位置設定為 cp;也就是說,範圍會變成插入點。

如果此範圍實際上是選取範圍,結束位置會變成使用中結束,如果顯示未凍結,則會捲動到檢視中。

ITextRange::SetStart 會設定範圍的開始位置,而 ITextRange::SetRange 會 同時設定這兩個範圍結尾。 若要將非產生的範圍 r 轉換成一個 (插入點) 在開始位置的變質,請使用

r.End = r.Start

同樣地,r.Start = r.End 會將 r 轉換成結束位置的插入點。

若要將 1 新增至結束位置,除非它位於本文結尾,請使用:

r.End = r.End + 1

這也會讓結束位置成為使用中端,而且可以將變質的範圍轉換成非產生的範圍。

規格需求

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

另請參閱

概念

GetEnd

ITextRange

參考

SetRange

SetStart

文字物件模型