다음을 통해 공유


IInkAnalyzer::AddStrokeForLanguage 메서드

단일 스트로크에 대한 스트로크 데이터를 IInkAnalyzer 에 추가하고 스트로크에 특정 문화권 식별자를 할당합니다.

구문

HRESULT AddStrokeForLanguage(
  [in]  LONG         lStrokeId,
  [in]  LONG         lStrokeLCID,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

매개 변수

lStrokeId [in]

추가할 스트로크의 식별자입니다.

lStrokeLCID [in]

스트로크에 할당할 문화권 식별자입니다.

ulStrokePacketDataCount [in]

스트로크의 패킷 수입니다.

plStrokePacketData [in]

스트로크에 대한 패킷 데이터를 포함하는 배열입니다.

ulStrokePacketDescriptionCount [in]

각 패킷의 속성 수입니다.

pStrokePacketDescriptionGuids [in]

패킷 속성 식별자를 포함하는 배열입니다.

ppContextNodeStrokeAddedTo [out]

값이 새로 추가된 스트로크를 포함하는 IContextNode 의 포인터로 설정된 포인터입니다.

반환 값

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

설명

주의

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

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

IInkAnalyzer는 UnclassifiedInk 형식의 IContextNode에 스트로크를 추가합니다(컨텍스트 노드 형식 참조). 이 노드는 루트 노드의 하위 노드 컬렉션에 있습니다( IInkAnalyzer::GetRootNode 메서드IContextNode::GetSubNodes 메서드 참조).

IInkAnalyzer는 스트로크에 lStrokeLCID 문화권 식별자를 할당하고 동일한 문화권 식별자가 있는 스트로크를 포함하는 잉크 분석기 루트 노드 아래의 첫 번째 UnclassifiedInk 컨텍스트 노드에 스트로크를 추가합니다. 잉크 분석기에서 문화권 식별자가 동일한 노드가 없는 경우 루트 노드 아래에 새 UnclassifiedInk 컨텍스트 노드를 만들고 새 UnclassifiedInk 컨텍스트 노드에 스트로크를 추가합니다.

plStrokePacketData 는 스트로크의 모든 지점에 대한 패킷 데이터를 포함합니다. pStrokePacketDescriptionGuids 에는 스트로크의 각 지점에 포함된 패킷 데이터의 형식을 설명하는 GUID(Globally Unique Identifier)가 포함되어 있습니다. 사용 가능한 패킷 속성의 전체 목록은 PacketPropertyGuids 상수를 참조하세요.

이 메서드는 더티 영역을 지역의 현재 값과 추가된 스트로크의 경계 상자의 합합으로 확장합니다.

IInkAnalyzer에 동일한 스트로크 식별자가 있는 스트로크가 이미 포함되어 있는 경우 IInkAnalyzerE_INVALIDARGHRESULT를 반환합니다.

요구 사항

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

추가 정보

IInkAnalyzer

IInkAnalyzer::AddStroke 메서드

IInkAnalyzer::AddStrokes 메서드

IInkAnalyzer::AddStrokesForLanguage 메서드

IInkAnalyzer::RemoveStroke 메서드

IInkAnalyzer::RemoveStrokes 메서드

잉크 분석 참조