ITextRange::MoveEndWhile 方法 (tom.h)

移動範圍結尾 :Count 字元,或只超過 Cset所指定字元集中找到的所有連續字元,無論哪一個都少。

語法

HRESULT MoveEndWhile(
  VARIANT *Cset,
  long    Count,
  long    *pDelta
);

參數

Cset

類型: VARIANT*

要用於比對的字元集。 這可能是字元或字元集索引的明確字串。 如需詳細資訊,請參閱 字元比對集

Count

類型: long

要移動的字元數上限。 預設值為 tomForward,它會搜尋本文結尾。 如果 Count 大於零,搜尋會向前移動 (到本文結尾) 。 如果 Count 小於零,則搜尋會向後移動 (到本文開頭) 。 如果 Count 為零,則結束位置不會變更。

pDelta

類型: long*

結束移動的實際字元數。 此值可以是 null。

傳回值

類型: HRESULT

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

傳回碼 描述
E_INVALIDARG
Cset 無效。
S_FALSE
因其他原因而失敗。

備註

如果新結束在舊開始之前,新開始會設定為等於新結束。

ITextRange::MoveEndWhile所描述的動作是邏輯而非幾何。 也就是說,動作是接近結尾或到故事的開頭。 視語言而定,移至本文結尾可能會向左移動或向右移動。

如需詳細資訊,請參閱 ITextRangeITextRange::Move

需求

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

另請參閱

概念

ITextRange

移動

MoveWhile

參考

文字物件模型