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

아티클
03/09/2024

범위의 끝을 Cset에서 지정한 문자 집합에 있는 첫 번째 문자의 문자 위치로 이동합니다. 범위 끝의 Count 문자 내에 문자가 있는 경우 입니다.

구문

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

매개 변수

Cset

형식: VARIANT*

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

Count

형식: long

지나갈 최대 문자 수입니다. 기본값은 스토리의 끝을 검색하는 tomForward입니다. Count가 0보다 크면 검색이 앞으로 이동합니다(스토리의 끝). Count가 0보다 작으면 검색이 뒤로 이동합니다(스토리의 시작 부분으로 이동). Count가 0이면 끝 위치가 변경되지 않습니다.

pDelta

형식: long*

범위 끝이 이동된 실제 문자 수와 Count가 0보다 큰 경우 일치 항목의 경우 1, Count가 0보다 작은 경우 일치 항목의 경우 –1입니다. 값은 null일 수 있습니다.

반환 값

형식: HRESULT

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

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

설명

범위 끝의 Count 위치 내에 Cset에 지정된 집합의 문자가 없으면 범위는 변경되지 않은 상태로 유지됩니다. 새 끝이 이전 시작 앞에 있으면 새 시작이 새 끝과 동일하게 설정됩니다.

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

자세한 내용은 ITextRange 및 ITextRange::Move를 참조하세요.

요구 사항

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