InkEdit.Gesture 이벤트
애플리케이션 제스처가 인식될 때 발생합니다.
구문
HRESULT Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
매개 변수
-
커서 [in]
-
이 제스처를 만드는 데 사용된 IInkCursor 개체입니다.
-
스트로크 [in]
-
이 제스처를 구성하는 IInkStrokeDisp 개체를 포함하는 InkStrokes 컬렉션입니다.
-
제스처 [in]
-
신뢰할 수 있는 IInkGesture 개체의 배열입니다.
VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.
-
취소 [in, out]
-
잉크를 지우지 않고 Stroke 이벤트를 발생시키지 않도록 이 제스처를 구성하는 InkStrokes 컬렉션을 취소해야 하는지 여부입니다.
반환 값
이 이벤트가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 이벤트 메서드는 _IInkEditEvents 인터페이스에 정의되어 있습니다. _IInkEditEvents 인터페이스는 DISPID_IeeGesture 식별자를 사용하여 IDispatch 인터페이스를 구현합니다.
제스처 이벤트는 Recognize 메서드에 대한 마지막 호출 또는 인식 시간 제한의 마지막 실행 이후 IInkGesture 개체의 IInkStrokeDisp가 첫 번째 IInkStrokeDisp 개체인 경우에만 발생합니다.
Gesture 이벤트가 취소되면 Gesture 이벤트를 발생시킨 InkStrokes 컬렉션에 대한 Stroke이벤트가 발생합니다.
이 이벤트가 발생하려면 InkEdit 컨트롤이 애플리케이션 제스처 집합을 구독해야 합니다. 제스처 집합에 InkEdit 컨트롤의 관심을 설정하려면 SetGestureStatus 메서드를 호출합니다.
애플리케이션 제스처 목록은 InkApplicationGesture 열거형 형식을 참조하세요.
InkEdit 컨트롤은 여러 스트로크 제스처를 인식하지 못합니다.
InkEdit 컨트롤은 다음 제스처를 구독합니다.
| 제스처 | 작업 |
|---|---|
| 왼쪽 아래, 왼쪽 아래 길이 |
Enter 키 |
| 오른쪽 |
Space |
| 왼쪽 |
백스페이스 |
| 오른쪽 위로, 오른쪽 위로 |
탭 |
제스처에 대한 기본 동작을 변경하려면 다음을 수행합니다.
- 제스처 및 스트로크 이벤트에 대한 이벤트 처리기를 추가합니다.
- 제스처 이벤트 처리기에서 제스처에 대한 제스처 이벤트를 취소하고 제스처에 대한 대체 작업을 수행합니다.
- Stroke 이벤트 처리기에서 취소된 제스처 이벤트를 발생시킨 IInkStrokeDisp 개체에 대한 Stroke 이벤트를 취소합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|
| 라이브러리 |
|