Событие InkCollector.Gesture
Происходит при распознавании жеста приложения.
Синтаксис
void Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
Параметры
-
Курсор [in]
-
Объект IInkCursor , создающий событие Gesture .
-
Штрихи [in]
-
Коллекция IInkStrokes , возвращенная распознавателями в качестве жеста.
-
Жесты [в]
-
Массив объектов IInkGesture в порядке достоверности из распознавателя.
Дополнительные сведения о структуре VARIANT см. в разделе Использование библиотеки COM.
-
Cancel [in, out]
-
VARIANT_TRUE , следует ли отменить этот жест; в противном случае VARIANT_FALSE.
Возвращаемое значение
Это событие не возвращает значение.
Комментарии
Этот метод события определяется в интерфейсах _IInkCollectorEvents, _IInkOverlayEvents и _IInkPictureEvents только для диспетчеризации (dispinterfaces) с идентификатором DISPID_ICEGesture.
Если свойству CollectionMode присвоено значение GestureOnly, время ожидания между добавлением пользователем жеста и событием Жест является фиксированным значением, которое нельзя изменить программным способом. Распознавание жестов выполняется быстрее в режиме InkAndGesture .
Чтобы предотвратить сбор рукописного ввода в режиме InkAndGesture , выполните следующие действия.
- Для параметра CollectionMode задайте значение InkAndGesture.
- Удаление росчерка в событии Stroke .
- Обработайте жест в событии Жест .
Чтобы предотвратить поток рукописного ввода во время жестикулирования, задайте для свойства DynamicRenderingзначение FALSE.
Помимо вставки рукописного ввода, событие Жест запускается в режиме выбора или стирания. Вы отвечаете за отслеживание режима редактирования и должны быть осведомлены о режиме перед интерпретацией события.
Примечание
Для распознавания жестов необходимо использовать объект или элемент управления, который может собирать рукописные фрагменты.
Жесты приложения определяются как жесты, поддерживаемые в приложении.
Чтобы это событие произошло, объект или элемент управления должен иметь интерес к набору жестов приложения. Чтобы задать интерес объектов или элементов управления в наборе жестов, вызовите метод SetGestureStatus объекта или элемента управления.
Список определенных жестов приложения см. в разделе Тип перечисления InkApplicationGesture .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| Библиотека |
|