IInkRecognitionAlternate::GetStrokesFromTextRange 메서드(msinkaut.h)

  • 아티클

대체 항목 내에서 지정된 문자 범위를 포함하는 가장 작은 인식 세그먼트 집합에 해당하는 컬렉션을 검색합니다.

구문

HRESULT GetStrokesFromTextRange(
  [in, out]     long        *selectionStart,
  [in, out]     long        *selectionLength,
  [out, retval] IInkStrokes **GetStrokesFromTextRange
);

매개 변수

[in, out] selectionStart

이 대체 문자 범위의 시작입니다. selectionStart 위치의 문자는 인식된 텍스트 범위에 포함됩니다. 이 매개 변수는 입력 선택을 포함하는 하나 이상의 세그먼트에서 인식되는 가장 작은 집합의 시작 부분으로 조정됩니다. selectionStart 매개 변수는 인식 대체 텍스트의 문자에 대한 인덱스(0부터 시작)입니다.

[in, out] selectionLength

대체 문자 범위의 길이입니다. 이 매개 변수는 0보다 커야 합니다. 이 매개 변수는 입력 선택을 포함하는 하나 이상의 세그먼트 중 가장 작은 집합의 길이로 조정됩니다.

[out, retval] GetStrokesFromTextRange

반환 시 인식된 텍스트의 알려진 범위에 해당하는 스트로크 컬렉션에 대한 포인터를 포함합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 성공.
E_POINTER
 매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION
 메서드 내에서 예외가 발생했습니다.
E_FAIL
 지정되지 않은 오류가 발생했습니다.
E_OUTOFMEMORY
 스트로크 처리기 도우미 개체를 할당할 수 없습니다.

설명

GetStrokesFromTextRange를 더 명확히 하려면 인식된 스트로크 컬렉션을 고려하고 해당 스트로크에 가장 적합한 대안은 "how are you"입니다. 메서드에 전달된 매개 변수는 이 문자열 결과 내의 일부 범위(또는 모두)입니다. 이 대체 항목에는 각 단어에 하나씩, 각 공간에 하나씩 5개의 세그먼트가 포함됩니다. 반환되는 스트로크는 모든 입력 범위를 포함하는 가장 작은 세그먼트 집합에 해당합니다. selectionStart 매개 변수가 0이고 selectionLength 매개 변수가 5이면 결과 문자열의 "how a"에 해당하는 범위를 만들면 반환되는 스트로크는 세그먼트 "how are"를 구성하는 인식된 모든 스트로크입니다. 입력 범위를 포함하는 가장 작은 세그먼트 집합입니다.

단어와 문자 기반 인식기 모두에서 공백은 문자로 계산됩니다. 입력 선택 영역이 공백 문자에 해당하는 경우 이 메서드는 InkStrokes 컬렉션을 반환하고 빈 InkStrokes 컬렉션을 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 msinkaut.h
라이브러리 InkObj.dll

추가 정보

GetStrokesFromStrokeRanges 메서드

GetTextRangeFromStrokes 메서드

IInkRecognition 대체 인터페이스

InkStrokes 컬렉션