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에서 오류 처리를 참조하세요.
| 반환 코드 | 설명 |
|---|---|
|
pIndex 가 null입니다. |
|
단위가 없습니다. |
설명
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 |
추가 정보
개념
참조