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를 호출합니다.
ppContextNodeStrokeAddedTo가 NULL이면 호출자가 메서드의 반환 값에 관심이 없음을 나타냅니다.
IInkAnalyzer는 UnclassifiedInk 형식의 IContextNode에 스트로크를 추가합니다(컨텍스트 노드 형식 참조). 이 노드는 루트 노드의 하위 노드 컬렉션에 있습니다( IInkAnalyzer::GetRootNode 메서드 및 IContextNode::GetSubNodes 메서드 참조).
IInkAnalyzer는 스트로크에 lStrokeLCID 문화권 식별자를 할당하고 동일한 문화권 식별자가 있는 스트로크를 포함하는 잉크 분석기 루트 노드 아래의 첫 번째 UnclassifiedInk 컨텍스트 노드에 스트로크를 추가합니다. 잉크 분석기에서 문화권 식별자가 동일한 노드가 없는 경우 루트 노드 아래에 새 UnclassifiedInk 컨텍스트 노드를 만들고 새 UnclassifiedInk 컨텍스트 노드에 스트로크를 추가합니다.
plStrokePacketData 는 스트로크의 모든 지점에 대한 패킷 데이터를 포함합니다. pStrokePacketDescriptionGuids 에는 스트로크의 각 지점에 포함된 패킷 데이터의 형식을 설명하는 GUID(Globally Unique Identifier)가 포함되어 있습니다. 사용 가능한 패킷 속성의 전체 목록은 PacketPropertyGuids 상수를 참조하세요.
이 메서드는 더티 영역을 지역의 현재 값과 추가된 스트로크의 경계 상자의 합합으로 확장합니다.
IInkAnalyzer에 동일한 스트로크 식별자가 있는 스트로크가 이미 포함되어 있는 경우 IInkAnalyzer는 E_INVALIDARGHRESULT를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|
| DLL |
|