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

지정된 범위 시작 문자 위치에서 Unit 매개 변수의 스토리 인덱스를 검색합니다. 스토리의 첫 번째 단위 의 인덱스 값은 1입니다. Unit의 인덱스는 Unit 바로 앞의 모든 문자 위치부터 Unit 의 마지막 문자까지의 모든 문자 위치에 대해 동일합니다.

구문

HRESULT GetIndex(
  long Unit,
  long *pIndex
);

매개 변수

Unit

형식: long

인덱싱된 단위입니다. 가능한 단위 값 목록은 ITextRange 아래의 토론을 참조하세요.

pIndex

형식: long*

인덱스 값입니다. Unit이 없으면 값이 0입니다.

반환 값

형식: HRESULT

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

반환 코드	설명
E_INVALIDARG	pIndex 가 null입니다.
E_NOTIMPL	단위가 없습니다.

설명

ITextRange::GetIndex 메서드는 Start 범위에서 단어, 줄, 문장, 단락 등의 스토리 인덱스를 검색합니다. 단위 는 단어(tomWord), 선(tomLine), 문장(tomSentence) 또는 단락(tomParagraph)과 같이 인덱싱할 엔터티 종류를 지정합니다. 예를 들어 ITextRange::GetIndex 는 범위에서 첫 번째 줄의 줄 번호와 같은 pIndex 를 설정합니다. 스토리 끝에 있는 범위의 경우 ITextRange::GetIndex는 스토리의 단위수를 반환합니다. 따라서 스토리에서 단어, 선, 개체 등의 수를 가져올 수 있습니다.

이후에 텍스트를 편집하는 경우 ITextRange::GetIndex 메서드에서 반환된 인덱스 값이 유효하지 않습니다. 따라서 사용자는 특히 값이 어떤 기간 동안 저장되어야 하는 경우 인덱스 값을 반환하는 메서드를 사용하는 데 주의해야 합니다. 이는 텍스트를 편집할 때 유효한 상태로 유지되는 범위에 대한 포인터와는 대조적입니다.

요구 사항

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

추가 정보

개념

ITextRange

참조

텍스트 개체 모델