ITextRange：：MoveStartUntil 方法 (tom.h)

如果字元位於起始位置的 Count 字元內，則會移動範圍之第一個字元在 Cset 所指定字元集中的位置。

語法

HRESULT MoveStartUntil(
  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：：MoveStartUntil 所描述的動作是邏輯而非幾何。也就是說，動作是接近故事的結尾或開始。視語言而定，移至本文結尾可能會向左移動或向右移動。

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

概念

參考