Событие InkEdit.Gesture
Происходит при распознавании жеста приложения.
Синтаксис
HRESULT Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
Параметры
-
Курсор [в]
-
Объект IInkCursor , который использовался для создания этого жеста.
-
Штрихи [в]
-
Коллекция InkStrokes , содержащая объекты IInkStrokeDisp , составляющие этот жест.
-
Жесты [в]
-
Массив объектов IInkGesture в порядке достоверности.
Дополнительные сведения о структуре VARIANT см. в разделе Использование библиотеки COM.
-
Cancel [in, out]
-
Следует ли отменить коллекцию InkStrokes , из которую состоит этот жест, чтобы не удалить рукописный фрагмент и создать событие Stroke .
Возвращаемое значение
Если это событие завершается успешно, оно возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Этот метод события определен в интерфейсе _IInkEditEvents . Интерфейс _IInkEditEvents реализует интерфейс IDispatch с идентификатором DISPID_IeeGesture.
Событие Жест возникает только в том случае, если IInkStrokeDisp для объекта IInkGesture является первым объектом IInkStrokeDisp с момента последнего вызова метода Recognize или последнего срабатывания времени ожидания распознавания.
Если событие Gesture отменено, событие Stroke вызывается для коллекции InkStrokes , которая вызвала событие Жест .
Для этого события элемент управления InkEdit должен подписаться на набор жестов приложения. Чтобы задать интерес элемента управления InkEdit к набору жестов, вызовите метод SetGestureStatus .
Список жестов приложения см. в разделе Тип перечисления InkApplicationGesture .
Элемент управления InkEdit не распознает несколько жестов росчерка.
Элемент управления InkEdit подписывается на следующие жесты.
| жесты | Действие |
|---|---|
| Вниз влево, вниз-влево-long |
Введите: |
| Правый |
Пробел |
| Левый |
Отмена |
| Вверх-справа, вверх-справа-long |
Вкладка |
Чтобы изменить действие по умолчанию для жеста, выполните следующие действия:
- Добавление обработчиков событий жеста и росчерка .
- В обработчике событий Жест отмените событие Жест для жеста и выполните альтернативное действие для жеста.
- В обработчике событий Stroke отмените событие Stroke для объекта IInkStrokeDisp , который вызвал событие canceled Gesture .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| Библиотека |
|