InkCollector.Gesture 이벤트

애플리케이션별 제스처가 인식될 때 발생합니다.

구문

void Gesture(
  [in]      IInkCursor   *Cursor,
  [in]      IInkStrokes  *Strokes,
  [in]      VARIANT      Gestures,
  [in, out] VARIANT_BOOL *Cancel
);

매개 변수

커서 [in]

제스처 이벤트를 생성한 IInkCursor 개체입니다.

스트로크 [in]

인식기가 제스처로 반환한 IInkStrokes 컬렉션입니다.

제스처 [in]

인식기에서 신뢰도 순서로 IInkGesture 개체의 배열입니다.

VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

취소 [in, out]

제스처를 취소해야 하는지 VARIANT_TRUE. 그렇지 않으면 VARIANT_FALSE.

반환 값

이 이벤트는 값을 반환하지 않습니다.

설명

이 이벤트 메서드는 id가 DISPID_ICEGesture _IInkCollectorEvents, _IInkOverlayEvents 및 _IInkPictureEvents 디스패치 전용 인터페이스(dispinterfaces)에 정의됩니다.

CollectionMode 속성을 GestureOnly로 설정하면 사용자가 제스처를 추가할 때와 제스처 이벤트가 발생할 때 사이의 시간 제한은 프로그래밍 방식으로 변경할 수 없는 고정 값입니다. 제스처 인식은 InkAndGesture 모드에서 더 빠릅니다.

InkAndGesture 모드에서 잉크 수집을 방지하려면 다음을 수행합니다.

  • CollectionModeInkAndGesture로 설정합니다.
  • Stroke 이벤트에서 스트로크를 삭제합니다.
  • 제스처 이벤트에서 제스처를 처리합니다.

몸짓하는 동안 잉크 흐름을 방지하려면 DynamicRendering 속성을 FALSE로 설정합니다.

잉크를 삽입할 때 외에도 선택 또는 지우기 모드에서 제스처 이벤트가 발생합니다. 편집 모드를 추적해야 하며 이벤트를 해석하기 전에 모드를 알고 있어야 합니다.

참고

제스처를 인식하려면 잉크를 수집할 수 있는 개체 또는 컨트롤을 사용해야 합니다.

애플리케이션 제스처는 애플리케이션 내에서 지원되는 제스처로 정의됩니다.

이 이벤트가 발생하려면 개체 또는 컨트롤이 애플리케이션 제스처 집합에 관심이 있어야 합니다. 개체 또는 컨트롤이 제스처 집합에 관심을 가지도록 설정하려면 개체 또는 컨트롤의 SetGestureStatus 메서드를 호출합니다.

특정 애플리케이션 제스처 목록은 InkApplicationGesture 열거형 형식을 참조하세요.

요구 사항

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

추가 정보

InkCollector 클래스

InkApplicationGesture 열거형

SetGestureStatus 메서드

제스처 사용