ITextRange::MoveUntil 메서드(tom.h)

아티클
03/06/2024

Cset에서 지정한 문자 집합의 첫 번째 문자에 대해 최대 개수 문자 수를 검색합니다. 문자가 발견되면 범위가 해당 지점으로 축소됩니다. 검색 시작과 방향도 Count로 지정됩니다.

구문

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

매개 변수

Cset

형식: VARIANT*

일치 항목에 사용되는 문자 집합입니다. 이는 명시적 문자 문자열 또는 문자 집합 인덱스일 수 있습니다. 자세한 내용은 문자 일치 집합을 참조하세요.

Count

형식: long

지나갈 최대 문자 수입니다. 기본값은 스토리의 끝을 검색하는 tomForward입니다. Count가 0보다 작으면 검색이 시작 위치에서 뒤로 시작됩니다. Count가 0보다 크면 검색이 끝에서 시작됩니다.

pDelta

형식: long*

삽입 지점이 이동된 문자 수와 Count가 0보다 큰 경우 일치 항목의 경우 1, Count 가 0 보다 작으면 일치 항목의 경우 –1입니다. 포인터는 null일 수 있습니다.

반환 값

형식: HRESULT

메서드는 HRESULT 값을 반환합니다. 메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 다음 오류 코드 중 하나를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	설명
E_INVALIDARG	Cset 가 잘못되었습니다.
S_FALSE	다른 이유로 인해 실패합니다.

설명

일치하는 문자가 없으면 범위가 변경되지 않습니다.

ITextRange::MoveUntil에서 설명하는 동작은 기하학적 동작이 아닌 논리적입니다. 즉, 움직임은 이야기의 끝을 향해 또는 이야기의 시작을 향해있다. 언어에 따라 이야기의 끝으로 이동하면 왼쪽으로 이동하거나 오른쪽으로 이동할 수 있습니다.

자세한 내용은 ITextRange의 토론 및 ITextRange ::Move의 설명 섹션을 참조하세요.

ITextRange::MoveStartUntil 및 ITextRange::MoveEndUntil 메서드는 Cset 매개 변수로 지정된 집합에 있는 첫 번째 문자를 발견할 때까지 각각 시작과 끝을 이동합니다.

ITextRange::MoveUntil 메서드는 ITextRange::MoveWhile와 비슷하지만 두 가지 차이점이 있습니다. 먼저 MoveUntil은 Cset에서 지정한 문자 집합에 속하는 첫 번째 문자를 발견할 때까지 삽입 지점을 이동합니다. 둘째, MoveUntil 에서 일치하는 문자는 pDelta에서 반환된 값의 추가 문자로 계산됩니다. 이렇게 하면 삽입 지점이 범위 끝 중 하나에 유지되더라도 범위의 한쪽 끝이나 다른 쪽 끝에 있는 문자가 Cset 에 속한다는 것을 알 수 있습니다.

예를 들어 범위 r이 삽입 지점이라고 가정합니다. r의 문자(즉, r.GetChar()가 지정)가 Cset에 있는지 확인하려면 를 호출합니다.

r.MoveUntil(Cset, 1)

문자가 Cset에 있는 경우 반환 값은 1이고 삽입 지점은 이동하지 않습니다. 마찬가지로, 이전 r 문자가 Cset에 있는지 확인하려면 를 호출합니다.

r.MoveUntil(Cset, -1)

문자가 Cset에 있는 경우 반환 값은 –1입니다.

다음 Microsoft Visual Basic for Applications(VBA) 서브루틴은 r 범위로 식별된 스토리의 모든 숫자를 인쇄합니다.

Sub PrintNumbers (r As ITextRange)
   r.SetRange 0, 0    // r = insertion point at start of story
   While r.MoveUntil(C1_DIGIT)  // Move r to 1st digit in next number
      r.MoveEndWhile C1_DIGIT  // Select number (span of digits)
      Print r    // Print it
   Wend
End Sub

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	tom.h
DLL	Msftedit.dll