IInkAnalyzer::AddStrokesToCustomRecognizer 메서드
사용자 지정 인식기 노드에 여러 스트로크에 대한 스트로크 데이터를 추가합니다.
구문
HRESULT AddStrokesToCustomRecognizer(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plStrokeIds,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[in] IContextNode *pCustomRecognizer,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
매개 변수
-
ulStrokeIdsCount [in]
-
추가할 스트로크 수입니다.
-
plStrokeIds [in]
-
스트로크 식별자를 포함하는 배열입니다.
-
ulStrokePacketDescriptionCount [in]
-
각 패킷의 속성 수입니다.
-
pStrokePacketDescriptionGuids [in]
-
패킷 속성 식별자를 포함하는 배열입니다.
-
pulPacketDataCountPerStroke [in]
-
각 스트로크의 패킷 수를 포함하는 배열입니다.
-
plStrokePacketData [in]
-
스트로크에 대한 패킷 데이터를 포함하는 배열입니다.
-
pCustomRecognizer [in]
-
스트로크를 추가할 CustomRecognizer 형식의 IContextNode입니다.
-
ppContextNodeStrokeAddedTo [out]
-
잉크 분석기가 스트로크를 추가한 IContextNode 입니다.
반환 값
반환 값에 대한 설명은 클래스 및 인터페이스 - 잉크 분석을 참조하세요.
설명
주의
메모리 누수 방지를 위해 개체를 더 이상 사용할 필요가 없는 경우 ppContextNodeStrokeAddedTo에서 IUnknown::Release를 호출합니다.
ppContextNodeStrokeAddedTo가 NULL이면 호출자가 메서드의 반환 값에 관심이 없음을 나타냅니다.
IInkAnalyzer는 CustomRecognizer 형식의 IContextNode에 스트로크를 추가합니다(컨텍스트 노드 형식 참조). 이 노드는 루트 노드의 하위 노드 컬렉션에 있습니다( IInkAnalyzer::GetRootNode 메서드 및 IContextNode::GetSubNodes 메서드 참조).
IInkAnalyzer는 활성 입력 스레드의 문화권 식별자를 스트로크에 할당하고 CustomRecognizer 노드 아래의 첫 번째 UnclassifiedInk 노드에 스트로크를 추가합니다. UnclassifiedInk 노드가 없으면 만들어집니다. CustomRecognizer 노드와 연결된 IInkAnalysisRecognizer가 문화권 식별자를 지원하지 않는 경우 IInkAnalyzer는 계속 분석을 수행하고 IAnalysisWarning 경고를 생성합니다. 이 경고에는 AnalysisWarningCode 값 이 AnalysisWarningCode_LanguageIdNotRespected.
plStrokePacketData 는 모든 스트로크에 대한 패킷 데이터를 포함합니다. pStrokePacketDescriptionGuids 에는 각 스트로크의 각 지점에 포함된 패킷 데이터의 유형을 설명하는 GUID(Globally Unique Identifiers)가 포함되어 있습니다. 사용 가능한 패킷 속성의 전체 목록은 PacketPropertyGuids 상수를 참조하세요.
참고
동일한 패킷 설명이 있는 스트로크만 IInkAnalyzer::AddStrokesToCustomRecognizer 메서드에 대한 단일 호출에서 추가할 수 있습니다.
이 메서드는 더티 영역을 지역의 현재 값과 추가된 스트로크의 경계 상자의 합합으로 확장합니다.
IInkAnalyzer는 다음과 같은 상황에서 E_INVALIDARGHRESULT를 반환합니다.
- IInkAnalyzer에는 추가할 스트로크 중 하나와 동일한 식별자가 있는 스트로크가 이미 포함되어 있습니다.
- pCustomRecognizer 매개 변수에는 다른 IInkAnalyzer 개체와 연결된 사용자 지정 인식기 노드가 포함되어 있습니다.
- pCustomRecognizer 매개 변수에는 CustomRecognizer 형식이 아닌 IContextNode가 포함되어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|
| DLL |
|