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

아티클
08/25/2023

이 메서드가 호출되는 IInkRecognitionAlternate 개체의 분할인 IInkRecognitionAlternates 컬렉션을 검색합니다.

구문

HRESULT AlternatesWithConstantPropertyValues(
  [in]          BSTR                      PropertyType,
  [out, retval] IInkRecognitionAlternates **AlternatesWithConstantPropertyValues
);

매개 변수

[in] PropertyType

속성을 식별하는 문자열 값을 지정합니다. 사용할 수 있는 속성 목록은 RecognitionProperty를 참조하세요.

BSTR 데이터 형식에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

[out, retval] AlternatesWithConstantPropertyValues

이 메서드가 반환되면 이 메서드가 호출되는 대체 항목의 나누기로 구성된 IInkRecognitionAlternates 컬렉션이 포함됩니다. 컬렉션의 각 IInkRecognitionAlternate 개체에는 propertyType 매개 변수에 대해 동일한 속성 값이 있는 인접한 인식 세그먼트가 포함됩니다.

반환 값

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

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INVALIDARG	인식 범위가 잘못되었습니다.
E_INK_EXCEPTION	처리하는 동안 예외가 발생했습니다.
E_OUTOFMEMORY	작업을 완료하기 위해 메모리를 할당할 수 없습니다.

설명

컬렉션의 각 대체 항목에는 메서드에 전달된 속성의 속성 값이 동일한 인접 인식 세그먼트가 포함됩니다.

예를 들어 원래 대체 항목을 다음으로 나누는 대체 항목을 반환할 수 있습니다.

인식 결과가 강하거나 중간이거나 불량한 신뢰도 경계 수준입니다.
선 경계.
인식 세그먼트 경계.

속성 형식의 전체 목록은 RecognitionProperty를 참조하세요.

참고 인식기 인식 세그먼트에 스트로크의 구분을 결정 합니다. 공백과 같은 일부 인식 세그먼트는 빈 InkStrokes 컬렉션에 해당할 수 있습니다.

참고 인식기에서 인식 세그먼트의 순서를 결정합니다. 따라서 인접한 인식 세그먼트는 잉크가 그려진 순서를 기반으로 하거나 위치를 기반으로 할 수 있습니다. 예를 들어 잉크가 왼쪽에서 오른쪽으로 배치되었는지, 위쪽에서 아래쪽으로 배치되었는지 여부 등이 있습니다.

ConfidenceAlternates 속성은 AlternatesWithConstantPropertyValues 메서드의 대안입니다. 여기서 ConfidenceLevel은 반환된 인식 대체 컬렉션의 대체 항목을 구분하는 RecognitionProperty입니다.

LineAlternates 속성은 AlternatesWithConstantPropertyValues 메서드의 대안입니다. 여기서 LineNumber는 반환된 인식 대체 컬렉션의 대체 항목을 구분하는 RecognitionProperty입니다.

참고IInkRecognitionAlternate 개체의 AlternatesWithConstantPropertyValues 메서드, LineAlternates 속성 및 ConfidenceAlternates 속성은 IInkRecognitionResult 개체의 AlternatesFromSelection 메서드와 다르게 작동합니다. AlternatesFromSelection 은 인식 결과의 요청된 세그먼트에 대한 대체 항목 컬렉션을 반환합니다.

요구 사항

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