다음을 통해 공유

IInkAnalyzer 인터페이스

  • 아티클

레이아웃 분석, 쓰기 및 그리기 분류 및 필기 인식에 대한 액세스를 제공합니다.

멤버

IInkAnalyzer 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IInkAnalyzer 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IInkAnalyzer 인터페이스에는 이러한 메서드가 있습니다.

메서드 설명
중단 현재 분석 작업을 취소합니다.
AddStroke 단일 스트로크에 대한 스트로크 데이터를 IInkAnalyzer 에 추가하고 활성 입력 스레드의 문화권 식별자를 스트로크에 할당합니다.
AddStrokeForLanguage 단일 스트로크에 대한 스트로크 데이터를 IInkAnalyzer 에 추가하고 스트로크에 특정 문화권 식별자를 할당합니다.
AddStrokes 여러 스트로크에 대한 스트로크 데이터를 IInkAnalyzer 에 추가하고 활성 입력 스레드의 문화권 식별자를 스트로크에 할당합니다.
AddStrokesForLanguage 여러 스트로크에 대한 스트로크 데이터를 IInkAnalyzer 에 추가하고 지정된 문화권 식별자를 스트로크에 할당합니다.
AddStrokesToCustomRecognizer 사용자 지정 인식기 노드에 여러 스트로크에 대한 스트로크 데이터를 추가합니다.
AddStrokeToCustomRecognizer 단일 스트로크에 대한 스트로크 데이터를 사용자 지정 인식기 노드에 추가합니다.
분석 동기 잉크 분석을 수행합니다.
BackgroundAnalyze 비동기 잉크 분석을 수행합니다.
ClearStrokeData IInkAnalyzer에서 스트로크 패킷 데이터를 지웁니다.
CreateAnalysisHint 무한 영역이 있는 새 분석 힌트 노드를 IInkAnalyzer에 추가합니다.
CreateContextNodes IContextNodes 개체를 만듭니다.
CreateCustomRecognizer IInkAnalyzer에 대한 새 사용자 지정 인식기 노드를 만듭니다.
DeleteAnalysisHint IInkAnalyzer에서 분석 힌트를 제거합니다.
FindInkLeafNodes 모든 잉크 리프 노드를 검색합니다.
FindInkLeafNodesForStrokes 지정된 스트로크를 포함하는 잉크 리프 노드를 검색합니다.
FindLeafNodes 모든 리프 노드를 검색합니다.
FindNode 지정된 GUID(Globally Unique Identifier)에 대한 IContextNode 개체를 검색합니다.
FindNodesOfType 지정된 형식의 모든 IContextNode 개체를 검색합니다.
FindNodesOfTypeForStrokes 지정된 스트로크를 포함하는 지정된 형식의 모든 IContextNode 개체를 검색합니다.
FindNodesOfTypeInSubTree 지정된 IContextNode 개체의 하위 항목인 지정된 형식의 모든 IContextNode 개체를 검색합니다.
FindNodesWithCallBack 지정된 조건과 일치하는 모든 IContextNode 개체를 검색합니다.
FindNodesWithCallBackInSubTree 지정된 조건과 일치하고 지정된 IContextNode 개체의 하위 항목인 모든 IContextNode 개체를 검색합니다.
GetAlternates IInkAnalyzer와 연결된 모든 잉크에 대해 10개의 분석 대체를 검색합니다.
GetAlternatesForContextNodes 지정된 IContextNodes 컬렉션의 노드에 대한 분석 대체를 검색합니다.
GetAlternatesForStrokes 지정된 스트로크 식별자를 사용하여 스트로크에 대한 분석 대체를 검색합니다.
GetAnalysisHints IInkAnalyzer에 연결된 모든 분석 힌트 IContextNode 개체를 검색합니다.
GetAnalysisHintsByName IInkAnalyzer에 연결되고 지정된 이름을 가진 모든 분석 힌트 IContextNode 개체를 검색합니다.
GetAnalysisModes IInkAnalyzer가 잉크 분석을 수행하는 방법을 제어하는 플래그를 검색합니다.
GetDirtyRegion 마지막 분석 작업 이후 변경된 영역을 검색합니다.
GetInkAnalysisRecognizersByPriority IInkAnalysisRecognizer 개체의 정렬된 컬렉션을 검색합니다.
GetNodesFromTextRange 지정된 컨텍스트 노드의 지정된 텍스트 범위와 관련된 IContextNode 개체의 컬렉션을 검색합니다.
GetRecognizedString IInkAnalyzer에서 전체 컨텍스트 노드 트리에 대한 인식 작업의 최상의 결과 문자열을 검색합니다.
GetRootNode IInkAnalyzer 개체의 컨텍스트 트리의 루트 IContextNode를 검색합니다.
GetStrokeLanguageId 지정된 스트로크의 로캘 식별자를 검색합니다.
GetStrokeType 지정된 스트로크의 형식을 검색합니다.
GetTextRangeFromNodes IContextNode 개체의 컬렉션에 해당하는 인식된 문자열에서 텍스트 범위를 찾습니다.
IsAnalyzing IInkAnalyzer가 잉크 분석을 수행하는지 여부를 나타내는 값을 검색합니다.
LoadResults 저장된 분석 결과를 IInkAnalyzer에 로드합니다.
ModifyTopAlternate 현재 상위 대체 항목을 지정된 대체 개체로 변경하고 대체 개체와 연결된 모든 IContextNode 개체에 대한 확인 유형을 지웁니다.
ModifyTopAlternateWithConfirmation 현재 상위 대체를 지정된 IAnalysisAlternate로 변경합니다.
Reconcile 백그라운드 잉크 분석 중에 변경된 분석 결과의 부분을 결정합니다.
RemoveStroke IInkAnalyzer에서 지정된 스트로크를 제거합니다.
RemoveStrokes IInkAnalyzer에서 지정된 스트로크를 제거합니다.
SaveResults IInkAnalyzer에 대한 모든 분석 결과를 저장합니다.
SaveResultsForNodes IInkAnalyzer와 연결된 특정 컨텍스트 노드 컬렉션에 대한 분석 결과를 저장합니다.
SaveResultsForStrokes IInkAnalyzer와 연결된 지정된 스트로크에 대한 분석 결과를 저장합니다.
검색 분석된 쓰기 스트로크 및 인식된 형식이 있는 분석된 그리기 스트로크에 대한 유사하고 대/소문자를 구분하지 않는 구를 제공합니다.
SearchWithLanguageId 분석된 쓰기 스트로크 및 인식된 형식이 있는 분석된 그리기 스트로크에 대한 유사하고 대/소문자를 구분하지 않는 구를 제공합니다.
SetAnalysisModes IInkAnalyzer가 잉크 분석을 수행하는 방법을 제어하는 플래그를 수정합니다.
SetDirtyRegion 마지막 분석 작업 이후 변경된 영역을 수정합니다.
SetHighestPriorityInkAnalysisRecognizer 지정된 IInkAnalysisRecognizer 를 IInkAnalyzer 개체의 잉크 인식기 목록의 첫 번째 위치로 이동합니다.
SetStrokeLanguageId 지정된 스트로크의 로캘 식별자를 변경합니다.
SetStrokesLanguageId 지정된 스트로크에 대한 로캘 식별자를 변경합니다.
SetStrokesType 지정된 스트로크의 형식을 변경합니다.
SetStrokeType 지정된 스트로크의 형식을 변경합니다.
UpdateStrokesData 지정된 스트로크에 대한 패킷 데이터를 업데이트.

설명

IInkAnalyzer 는 스트로크 패킷 데이터를 사용하여 잉크를 분석하고 InkDisp 클래스 또는 InkStrokes 컬렉션 개체와 직접 상호 작용하지 않습니다.

분석을 위해 IInkAnalyzer 에 스트로크를 추가하거나 제거하려면 다음 방법 중 하나를 사용합니다.

이러한 메서드는 다음 분석 작업에서 스트로크를 분석하는 영역인 더티 지역(IInkAnalyzer::GetDirtyRegion 메서드 참조)을 업데이트합니다.

잉크를 분석하려면 IInkAnalyzer::Analyze 메서드 또는 IInkAnalyzer::BackgroundAnalyze 메서드를 사용합니다. 분석하는 동안 IInkAnalyzer 는 레이아웃 분석, 스트로크 분류 및 필기 인식을 수행합니다.

레이아웃 분석 및 스트로크 분류 설정을 변경하려면 IInkAnalyzer::SetAnalysisModes 메서드 속성을 사용합니다.

분석 중에 IInkAnalyzer 는 백그라운드 분석 중에 생성된 이벤트를 포함하여 여러 이벤트를 수신합니다. _IAnalysisProxyEventsIInkAnalyzer의 데이터 프록시 기능을 지원합니다. 자세한 내용은 잉크 분석을 사용하여 데이터 프록시를 참조하세요. 이벤트 처리기 내에서 분석 프로세스를 중지하려면 IInkAnalyzer::Abort 메서드를 호출합니다.

잉크 분석기가 필기를 인식하는 데 사용하는 언어를 수정하려면 IInkAnalyzer::SetStrokeLanguageId 메서드 또는 IInkAnalyzer::SetStrokesLanguageId 메서드를 사용합니다. 잉크 분석기가 특정 스트로크를 분류하는 방법을 수정하려면 IInkAnalyzer::SetStrokeType 메서드 또는 IInkAnalyzer::SetStrokesType 메서드를 사용합니다.

IInkAnalyzer는 설치된 모든 잉크 인식자에 대한 정보를 로드합니다. IInkAnalyzer::GetInkAnalysisRecognizersByPriority 메서드는 사용 가능한 각 IInkAnalysisRecognizer가 포함된 IInkAnalysisRecognizers 컬렉션을 반환합니다. 둘 이상의 잉크 인식기가 특정 언어를 지원하는 경우 IInkAnalyzer::SetHighestPriorityInkAnalysisRecognizer 메서드 를 사용하여 해당 언어에 대한 스트로크를 처리하는 잉크 인식기를 설정합니다.

분석 힌트를 사용하면 잉크 분석기에서 추가 컨텍스트를 제공하여 인식 정확도를 향상시킬 수 있습니다. 추가 컨텍스트 정보는 잉크 분석기가 가능한 인식 결과 수를 제한하는 데 도움이 될 수 있습니다. 예를 들어 factoid 및 예상 단어를 정의하거나 입력을 인식 가이드로 구성하여 scope 좁힐 수 있습니다. 잉크 분석기에서 컨텍스트를 제공하는 방법에 대한 자세한 내용은 다음을 참조하세요.

잉크 분석기는 분석 결과를 문자열 또는 IContextNode 개체의 트리로 나타냅니다. 인식된 문자열에 액세스하려면 IInkAnalyzer::GetRecognizedString 메서드를 사용합니다. 컨텍스트 노드 트리의 루트에 액세스하려면 IInkAnalyzer::GetRootNode 메서드를 사용합니다. 잉크 분석기는 특정 컨텍스트 노드 또는 텍스트를 찾는 다음과 같은 메서드를 사용합니다.

대체 분석 결과를 사용하려면 다음 방법 중 하나를 사용합니다.

분석 결과를 저장하려면 다음 방법 중 하나를 사용합니다.

저장된 결과를 로드하려면 IInkAnalyzer::LoadResults 메서드를 사용합니다.

IInkAnalyzer를 사용하여 잉크를 분석하는 방법에 대한 자세한 내용은 잉크 분석 개요를 참조하세요.

요구 사항

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

추가 정보

AnalysisModes

IAnalysisAlternate

IAnalysisStatus

IContextLink

IContextNode

잉크 분석 참조