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

아티클
03/13/2024

이 범위가 지정된 범위와 동일한 텍스트 내에 있는지 여부를 확인합니다.

구문

HRESULT InRange(
  ITextRange *pRange,
  long       *pValue
);

매개 변수

pRange

형식: ITextRange*

현재 범위와 비교되는 텍스트입니다.

pValue

형식: long*

비교 결과입니다. 포인터는 null일 수 있습니다. pB를 반환하는 메서드는 범위가 pRange와 같은 텍스트에 있거나 에 있는 경우에만 tomTrue입니다.

반환 값

형식: HRESULT

메서드는 HRESULT 값을 반환합니다. 메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 S_FALSE 반환합니다.

설명

range2를 range1에 포함하려면 두 범위가 모두 동일한 스토리에 있어야 하며 range2의 제한은 다음 문 중 하나를 충족해야 합니다.

range1의 시작 및 끝 문자 위치는 range2와 동일합니다. 즉, 두 범위가 모두 퇴화되고 삽입 지점이 동일합니다.
Range2는 range1의 위치 또는 범위 내에서 시작 및 끝 문자 위치가 있는 퇴화되지 않은 범위입니다.

다음 예제에서는 한 범위를 다른 범위로 걷는 방법을 보여 있습니다.

    range2 = range1.Duplicate
    range2.End = range2.Start       ' Collapse range2 to its start position 
    While range2.InRange(range1)    ' Iterate so long as range2 remains within range1
         ...   ' This code would change the range2 character positions 
    Wend

ITextRange::FindText, ITextRange::MoveWhile 및 ITextRange::MoveUntil 메서드 패밀리를 사용하는 경우 한 범위를 사용하여 문자의 적절한 제한 수를 지정하여 다른 범위를 이동할 수 있습니다(예: ITextRange::Find의 비고 참조).

ITextRange::IsEqual은 pRange의 시작 및 끝 문자 위치가 동일하고 동일한 스토리에 속하는 경우 pBtomTrue를 반환하는 ITextRange::InRange의 특수한 경우입니다.

요구 사항

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