IInkAnalyzer::CreateAnalysisHint 메서드

  • 아티클

무한 영역이 있는 새 분석 힌트 노드를 IInkAnalyzer에 추가합니다.

구문

HRESULT CreateAnalysisHint(
  [out] IContextNode **ppAnalysisHint
);

매개 변수

ppAnalysisHint [out]

새 분석 힌트 노드입니다.

반환 값

반환 값 에 대한 설명은 클래스 및 인터페이스 - 잉크 분석을 참조하세요.

설명

주의

메모리 누수 방지를 위해 개체를 더 이상 사용할 필요가 없는 경우 ppAnalysisHint에서 IUnknown::Release를 호출합니다.

IInkAnalyzer에 대한 추가 컨텍스트 정보를 제공하려면 잉크 분석기에서 분석 힌트를 추가할 수 있습니다. 분석 힌트는 인식 정확도를 향상시킬 수 있습니다. 예를 들어 양식 애플리케이션의 필드에 대한 factoid 및 가이드 정보를 추가할 수 있습니다.

이 메서드는 AnalysisHint의 컨텍스트 노드 형식(IContextNode::GetType 참조)을 사용하여 새 IContextNode를 만들고 IInkAnalyzer 개체의 루트 노드의 하위 노드로 새 힌트를 추가합니다(IContextNode::GetSubNodes 및 IInkAnalyzer::GetRootNode 메서드 참조).

힌트에 컨텍스트 정보를 추가하려면 pPropertyDataId 매개 변수가 Analysis Hint 속성 상수 중 하나로 설정된 IContextNode::AddPropertyData를 사용합니다.

힌트에 전역 힌트라고 하는 무한 영역이 할당되면 IInkAnalyzer 는 힌트의 컨텍스트를 다른 힌트 영역 내에 없는 모든 잉크에 적용합니다. 여러 힌트가 단일 IInkAnalyzer에 연결될 수 있습니다. 그러나 하나의 전역 힌트만 단일 잉크 분석기에 연결할 수 있으며 전역이 아닌 힌트는 겹칠 수 없습니다. 힌트가 제공할 수 있는 컨텍스트 정보의 형식에 대한 자세한 내용은 분석 힌트 속성을 참조하세요.

분석 힌트를 추가해도 다시 분석할 힌트 영역이 표시되지 않습니다. 재분석에 대한 힌트 내의 영역을 표시하려면 IInkAnalyzer::SetDirtyRegion 메서드를 사용하여 더티 지역을 현재 더티 영역과 분석 힌트 영역의 합집합으로 설정합니다.

양식 애플리케이션에 힌트를 사용하는 경우 애플리케이션은 텍스트 컨텍스트를 양식의 잉크와 혼합하지 않아야 합니다. 예를 들어 분석 트리에서 텍스트 필드 이름을 만들지 않아야 합니다. 힌트는 잉크를 페이지의 영역에 연결하기 위한 것입니다. 텍스트 컨텍스트가 이 잉크-힌트 연결을 방해합니다. 분석 작업은 잉크와 텍스트 컨텍스트를 동일한 쓰기 영역에 병합하여 잉크가 힌트 영역과 연결되지 않도록 할 수 있습니다.

잉크 분석에 대한 자세한 내용은 잉크 분석 개요를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
헤더
IACom.h(IACom_i.c 필요)
DLL
IACom.dll

추가 정보

IInkAnalyzer

IContextNode::AddPropertyData

IInkAnalyzer::D eleteAnalysisHint 메서드

IInkAnalyzer::GetAnalysisHints 메서드

IInkAnalyzer::GetAnalysisHintsByName 메서드

분석 힌트 속성

잉크 분석 참조