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

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

구문

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

개념

참조