다음을 통해 공유


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를 호출합니다.

ppContextNodeStrokeAddedToNULL이면 호출자가 메서드의 반환 값에 관심이 없음을 나타냅니다.

IInkAnalyzerCustomRecognizer 형식의 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 버전 [데스크톱 앱만 해당]
지원되는 최소 서버
지원되는 버전 없음
헤더
IACom.h(IACom_i.c도 필요)
DLL
IACom.dll

추가 정보

IInkAnalyzer

컨텍스트 노드 형식

IInkAnalyzer::AddStrokeToCustomRecognizer 메서드

IInkAnalyzer::CreateCustomRecognizer 메서드

잉크 분석 참조