ITextRange：：MoveWhile 方法 (tom.h)

發行項
03/09/2024

從指定的範圍結尾開始，並在字元屬於 Cset 所指定的集合時搜尋，而字元數目小於或等於 Count。找到不相符字元時，範圍會折疊成插入點。

語法

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

參數

Cset

類型： VARIANT*

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

Count

類型： long

要移動的字元數上限。默認值為 tomForward，它會搜尋本文結尾。如果 Count 小於零，則搜尋會從開始位置開始，然後向後向劇本開頭。如果 Count 大於零，則搜尋會從結束位置開始，然後往後- 往前- 往後。

pDelta

類型： long*

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

傳回值

類型： HRESULT

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

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

備註

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

如需詳細資訊，請參閱 ITextRange 中的討論和 ITextRange：：Move 的一節。

ITextRange：：MoveWhile 方法與 ITextRange：：MoveUntil 類似，但只要 MoveWhile 找到 Cset 所指定的集合成員，而且 pDelta 值沒有額外的增量即可搜尋 MoveWhile。

ITextRange：：MoveStartWhile 和 ITextRange：：MoveEndWhile 方法會分別移動開始和結束，只會分別移過 Cset 參數所指定之字元集中找到的所有連續字元。

VARIANT 類型主要是用於 IDispatch 案例，例如 Microsoft Visual Basic for Applications (VBA) ，但也可以從 C 或 C++ 使用。下列 C++ 程式代碼說明如何初始化及使用 VARIANT 自變數來比對範圍 r 中的數字範圍。

VariantInit(&varg);
varg.vt = VT_I4;
varg.lVal = C1_DIGIT;
hr = r.MoveWhile(&varg, tomForward, pDelta); // Move IP past span of digits

或者，可以使用明確的字串，如下列範例所示。

VariantInit(&varg);
bstr = SysAllocString("0123456789");
varg.vt = VT_BSTR;
varg.bstr = bstr;
hr =r.MoveWhile(&varg, tomForward, pDelta);    // Move IP past span of digits

下列 VBA 範例程序代碼符合範圍 r 中下一個標準一般化標記語言 (SGML) 專案的本文。 SGML 項目開頭為 <keyword ...> ，結尾為 </ 。 keyword>

r.Find <                  // Get to start of next tag
r.MoveWhile C1_SPACE      // Bypass any space characters
r.MoveEndWhile C1_ALPHA   // Match keyword
s$ = </ + r               // Create VBA string to search for
r.Find >                  // Bypass remainder of start tag
r.FindEnd s$              // Match up to end of closing keyword
r.FindEnd <, tomStart     // Back up to start of end tag
                          // r has body of SGML entry

規格需求

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