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 中的錯誤處理。

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

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

如需詳細資訊，請參閱 ITextRange 和 ITextRange：：Move。

概念

參考