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