Событие InkOverlay.Gesture

Статья
06/13/2023

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

Синтаксис

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

Параметры

Курсор [в]

Объект IInkCursor , создающий событие Gesture .

Штрихи [в]

Коллекция IInkStrokes , возвращенная распознавателем в качестве жеста.

Жесты [в]

Массив объектов IInkGesture в порядке достоверности из распознавателя.

Дополнительные сведения о структуре VARIANT см. в разделе Использование библиотеки COM.

Cancel [in, out]

Следует ли отменить коллекцию этого жеста, например, чтобы не стереть рукописный фрагмент и вызывать событие Stroke .

Возвращаемое значение

Это событие не возвращает значение.

Если свойству CollectionMode присвоено значение GestureOnly, время ожидания между добавлением жеста пользователем и событием Жест является фиксированным значением, которое нельзя изменить программным способом. Распознавание жестов выполняется быстрее в режиме InkAndGesture .

Чтобы предотвратить сбор рукописного ввода в режиме InkAndGesture, выполните следующие действия .

Задайте для параметра CollectionMode значение InkAndGesture.
Удаление росчерка в событии Stroke .
Обработайте жест в событии Жест .

Чтобы предотвратить поток рукописного ввода во время жестикуляционной обработки, задайте для свойства DynamicRenderingзначение FALSE.

Помимо вставки рукописного ввода, событие Жест запускается в режиме выбора или удаления. Вы несете ответственность за отслеживание режима редактирования и должны быть осведомлены о режиме перед интерпретацией события.

Примечание

Для распознавания жестов необходимо использовать объект или элемент управления, которые могут собирать рукописные фрагменты.

Жесты приложения определяются как жесты, поддерживаемые в приложении.

Чтобы это событие произошло, объект или элемент управления должны иметь интерес к набору жестов приложения. Чтобы задать интерес объектов или элементов управления в наборе жестов, вызовите метод SetGestureStatus объекта или элемента управления .

Список определенных жестов приложения см. в разделе Тип перечисления InkApplicationGesture .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Заголовок	Msinkaut.h (также требуется Msinkaut_i.c)
Библиотека	InkObj.dll

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

Класс InkOverlay
Перечисление InkApplicationGesture
Метод SetGestureStatus
Использование жестов

Share via