Событие InkEdit.Gesture

Статья
06/13/2023

Происходит при распознавании жеста приложения.

Синтаксис

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 .

Событие Жест возникает только в том случае, если 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 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Заголовок	Inked.h (также требуется inked_i.c)
Библиотека	InkEd.dll

См. также раздел

InkEdit
Перечисление InkApplicationGesture
Метод SetGestureStatus [элемент управления InkEdit]
Свойство RecoTimeout
Событие Stroke [элемент управления InkEdit]
Использование жестов

Share via