共用方式為


ITextRange::MoveEndUntil 方法 (tom.h)

將範圍的結尾移至第一個字元的字元位置,該字元位於 Cset 所指定的字元集中,前提是該字元位於範圍結尾的 Count 字元內。

語法

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

參數

Cset

類型: VARIANT*

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

Count

類型: long

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

pDelta

類型: long*

範圍結尾的實際字元數,如果 Count 大於零,則為相符專案加上 1;如果 Count 小於零,則為 -1。 此值可以是 null。

傳回值

類型: HRESULT

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

傳回碼 Description
意義
E_INVALIDARG
Cset 無效。
S_FALSE
因其他原因而失敗。

備註

如果在範圍結尾的 Count 位置內找不到 Cset 所指定集合中的字元,該範圍會保持不變。 如果新結束在舊開始之前,新開始會設定為等於新結束。

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

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

規格需求

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

另請參閱

概念

ITextRange

移動

MoveUntil

參考

文字物件模型