InkCollectionMode 열거형(msinkaut.h)

잉크, 제스처 또는 잉크 및 제스처가 사용자가 쓸 때 인식되는지 여부를 결정하는 값을 정의합니다.

Syntax

typedef enum InkCollectionMode {
  ICM_InkOnly = 0,
  ICM_GestureOnly,
  ICM_InkAndGesture
} ;

상수

ICM_InkOnly 값: 0 잉크만 수집하여 스트로크를 만듭니다. 제스처 이벤트 관심은 FALSE로 설정됩니다. 즉, 제스처가 수집되지 않습니다(다른 모든 이벤트 관심사는 그대로 유지됨).
ICM_GestureOnly 제스처만 수집하고 스트로크를 만들지 않습니다. 제스처는 단일 또는 다중 스트로크일 수 있습니다. 인식기의 기본 제공 타이머에 의해 설정된 시간 내에 스트로크가 만들어지면 다중 스트로크 제스처가 허용됩니다. 모든 스트로크 관련 및 패킷 관련 이벤트는 InkCollector에서 실행되지 않습니다. 커서 이벤트가 발생하며 잉크는 항상 삭제됩니다. 제스처 이벤트 관심은 TRUE로 설정됩니다. 즉, 제스처가 수집됩니다(다른 모든 이벤트 관심사는 그대로 유지됨).
ICM_InkAndGesture 단일 스트로크 제스처만 허용합니다. 제스처 이벤트가 먼저 실행되어 사용자에게CANCEL TRUE 또는 FALSE를 말할 = 수 있습니다. NoGesture가 기본 제스처인 경우를 제외하고 기본값은 TRUE이고 취소는 기본값이 FALSE입니다. TRUE이면 잉크가 제스처이며 삭제됩니다. FALSE이면 제스처가 잉크이고 Stroke 이벤트가 발생합니다. 제스처 이벤트 관심은 TRUE로 설정됩니다(다른 모든 이벤트 관심사는 그대로 유지됨).

설명

InkOnly 또는 InkAndGesture 모드에서 사용자가 마우스 오른쪽 단추를 클릭하고 펜을 이동하면 펜 팁에서 잉크가 흐릅니다. Stroke 이벤트를 처리할 때 펜 이동의 결과로 흐르는 잉크를 지워야 합니다.

InkCollectionMode가 GestureOnly(CollectionMode 속성을 통해 설정됨)로 설정된 경우 사용자가 제스처를 추가할 때와 제스처 이벤트가 발생하는 시점 사이의 시간 제한은 프로그래밍 방식으로 변경할 수 없는 고정 값입니다. 제스처 인식은 InkAndGesture 모드에서 더 빠릅니다. InkAndGesture 모드에서 잉크 수집을 방지하려면 다음을 수행할 수 있습니다.

• CollectionMode를 InkAndGesture로 설정합니다.
• Stroke 이벤트에서 스트로크 를 삭제합니다.
• 제스처 이벤트에서 제스처를 처리합니다.
• DynamicRendering을FALSE로 설정합니다.

Microsoft Windows XP Tablet PC Edition SDK(소프트웨어 개발 키트)가 설치되어 있지만 인식기가 없는 시스템에서 InkPicture 컨트롤(또는 InkCollector 또는 InkOverlay 개체)과 함께 이 열거형을 사용하는 경우 모드를 GestureOnly 또는 InkAndGesture로 설정할 수 없습니다.

잉크 수집기는 항상 스트로크(InkOnly 모드) 또는 제스처(GestureOnly 모드)를 만들고 경우에 따라 두 가지(InkAndGesture 모드)를 모두 만듭니다.

각 모드에 대한 일반적인 시나리오는 다음과 같습니다.

• InkOnly:
  1. CursorInRange 이벤트가 발생합니다.
  2. NewInAirPackets 이벤트가 발생합니다.
  3. CursorDown 이벤트가 발생합니다.
  4. NewPackets 이벤트가 발생합니다.
  5. IInkStrokeDisp 개체가 만들어집니다.
  6. CursorOutOfRange 이벤트가 발생합니다.
  참고CursorOutOfRange 이벤트를 항상 실행하지는 않을 수 있습니다. 잉크를 계속 그리려면 스트로크가 완료된 후 NewInAirPackets 또는 CursorDown 이벤트로 돌아갈 수 있습니다.
   
• GestureOnly:
  1. CursorInRange 이벤트가 발생합니다.
  2. NewInAirPackets 이벤트가 발생합니다.
  3. CursorDown 이벤트가 발생합니다.
  4. NewPackets 이벤트가 발생합니다.
  5. IInkGesture 개체가 만들어지거나 커서 이동이 제스처를 나타내지 않으면 아무 작업도 수행되지 않습니다.
  6. CursorOutOfRange 이벤트가 발생합니다.
  참고 이 모드에서는 단일 또는 다중 스트로크 제스처가 허용됩니다.
   
• InkAndGesture:
  1. CursorInRange 이벤트가 발생합니다.
  2. NewInAirPackets 이벤트가 발생합니다.
  3. CursorDown 이벤트가 발생합니다.
  4. NewPackets 이벤트가 발생합니다.
  5. IInkGesture 개체 또는 IInkStrokeDisp 개체가 만들어집니다.
  6. CursorOutOfRange 이벤트가 발생합니다.
  참고 이 모드에서는 단일 스트로크 제스처만 허용됩니다.
   

CollectionMode 속성을 InkAndGesture로 설정하고 SetGestureStatus 메서드를 호출하여 알려진 제스처에서 개체 또는 컨트롤의 관심사를 설정할 때 원치 않는 동작이 발생할 수 있습니다. 사용자가 인식기의 인식 대체 목록에 있는 제스처와 유사한 잉크를 그리면 제스처가 최상위 대체 항목이 아니더라도 제스처 이벤트가 실행되고 잉크가 사라집니다. 잉크가 사라지는 것을 방지하고 제스처 컬렉션을 취소하려면 이벤트가 인식기가 응답하지 않도록 하려면 취소 를 TRUE 로 설정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
머리글	msinkaut.h

추가 정보

CollectionMode 속성 [InkCollector 클래스]

제스처 이벤트

InkCollector 클래스

InkOverlay 클래스

InkPicture 컨트롤 참조

Stroke 이벤트