IInkCollector::get_CollectionMode 메서드(msinkaut.h)

  • 아티클

잉크, 제스처 또는 둘 다 사용자가 쓰는 것으로 인식되는지 여부를 결정하는 컬렉션 모드를 가져오거나 설정합니다.

이 속성은 읽기/쓰기가 가능합니다.

구문

HRESULT get_CollectionMode(
  InkCollectionMode *Mode
);

매개 변수

Mode

반환 값

없음

설명

사용할 수 있는 모드 목록은 InkCollectionMode 열거형 형식을 참조하세요. 그러나 Microsoft Windows XP Tablet PC Edition SDK(소프트웨어 개발 키트)가 설치되어 있지만 인식기가 설치되지 않은 시스템에서 CollectionMode 속성을 사용하는 경우 모드를 GestureOnly 또는 InkAndGesture로 설정할 수 없습니다.

참고 잉크를 수집하는 동안 CollectionMode 속성을 변경하려고 하면 InkCollector 개체, InkOverlay 개체 또는 InkPicture 컨트롤이 오류를 생성합니다. 이 충돌을 방지하려면 CollectionMode 속성을 변경하기 전에 CollectingInk 속성을 검사.
 
각 CollectionMode 값에 대해 다음과 같은 동작이 발생합니다.

InkOnly 모드

  • 잉크만 수집됩니다. 제스처는 그렇지 않습니다.
  • 제스처 이벤트 관심은 FALSE로 설정됩니다(다른 모든 이벤트 관심사는 그대로 유지됨).

GestureOnly 모드

  • 제스처만 수집됩니다. 잉크가 아닙니다. 스트로크는 제스처 인식기로 전송된 후 삭제됩니다.
  • 제스처 이벤트 관심은 TRUE로 설정됩니다(다른 모든 이벤트 관심사는 그대로 유지됨).
  • 잉크 수집기는 CursorDown, Stroke, NewPackets 및 NewInAirPackets 이벤트와 같은 스트로크 및 패킷 관련 이벤트를 실행하지 않습니다.
  • 커서 이벤트가 발생합니다.
  • 잉크는 항상 삭제됩니다.

InkAndGesture 모드

  • 잉크와 제스처가 모두 수집됩니다.
  • 단일 스트로크 제스처만 인식됩니다.
  • 제스처 이벤트 관심은 TRUE로 설정됩니다(다른 모든 이벤트 관심사는 그대로 유지됨).
  • 제스처 이벤트가 먼저 실행되므로 제스처를 수락하거나 취소할 수 있습니다. 제스처를 취소하려면 Cancel 매개 변수를 TRUE로 설정합니다. 제스처를 취소하면 잉크 수집기가 강제로 잉크를 수집합니다.
컬렉션 모드를 변경해도 개별 제스처의 상태 변경되지 않습니다.

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

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

  1. CollectionMode 속성을 InkAndGesture로 설정합니다.
  2. Stroke 이벤트에서 스트로크를 삭제합니다.
  3. 제스처 이벤트에서 제스처를 처리합니다.
  4. 몸짓을 하는 동안 잉크 흐름을 방지하려면 DynamicRendering 을 FALSE 로 설정합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 msinkaut.h
라이브러리 InkObj.dll

추가 정보

CollectingInk 속성

Enabled 속성

IInkCollector

InkCollectionMode 열거형

InkCollector 클래스