Перечисление InkCollectionMode (msinkaut.h)
Определяет значения, определяющие, распознаются ли рукописные фрагменты, жесты или рукописные и жесты как операции записи пользователем.
Синтаксис
typedef enum InkCollectionMode {
ICM_InkOnly = 0,
ICM_GestureOnly,
ICM_InkAndGesture
} ;
Константы
ICM_InkOnly Значение: 0 Собирает только рукописный ввод, создавая росчерк. Для интереса к событию Жест задано значение FALSE, что означает, что жесты не собираются (все остальные интересы событий остаются такими же, как и были). |
ICM_GestureOnly Собирает только жесты и не создает штрих. Жесты могут быть как одиночными, так и многотактными. Жесты с несколькими штрихами принимаются, если штрихи выполняются в течение времени, заданного встроенным таймером распознавателя. Все события, связанные с росчерком и пакетами, не запускают из InkCollector. События курсора активируются, и рукописный ввод всегда удаляется. Для параметра Интерес к событию Жест задано значение TRUE, что означает, что жесты собираются (все остальные интересы событий остаются прежними). |
ICM_InkAndGesture Принимает только жесты с одним росчерком. Сначала срабатывает событие Жест , что дает пользователю возможность произвести отмену = TRUE или FALSE. Значение по умолчанию — TRUE, за исключением случаев, когда основным жестом является NoGesture , по умолчанию отмена имеет значение FALSE. Если задано значение TRUE, рукописный ввод является жестом и удаляется. Если задано значение FALSE, жестом является рукописный ввод и возникает событие Stroke . Для интереса к событию Жест задано значение TRUE (все остальные интересы событий сохраняются как были). |
Комментарии
Если пользователь пытается щелкнуть правой кнопкой мыши и перемещает перо в режиме InkOnly или InkAndGesture, рукописный ввод передается из кончика пера. При обработке события Stroke необходимо очистить рукописный фрагмент, который был вытек в результате перемещения пера.
Если inkCollectionMode имеет значение GestureOnly (устанавливается с помощью свойства CollectionMode ), время ожидания между добавлением пользователем жеста и событием Жест является фиксированным значением, которое нельзя изменить программным способом. Распознавание жестов выполняется быстрее в режиме InkAndGesture. Чтобы предотвратить сбор рукописного ввода в режиме InkAndGesture, можно:
- Для параметра CollectionMode задайте значение InkAndGesture.
- В событии Stroke удалите росчерк.
- В событии Жест обработайте жест.
- Задайте для DynamicRenderingзначение FALSE.
Сборщик рукописного ввода всегда создает росчерк (режим InkOnly) или жест (режим GestureOnly), а иногда и оба (режим InkAndGesture).
Ниже приведены типичные сценарии для каждого режима.
- InkOnly:
- Срабатывает событие CursorInRange .
- Срабатывает событие NewInAirPackets .
- Срабатывает событие CursorDown.
- Срабатывает событие NewPackets .
- Создается объект IInkStrokeDisp.
- Срабатывает событие CursorOutOfRange .
Примечание Может потребоваться не всегда запускать событие CursorOutOfRange . Если вы хотите продолжить рисование рукописного ввода, вы можете вернуться к событиям NewInAirPackets или CursorDown после завершения росчерка. - GestureOnly:
- Срабатывает событие CursorInRange .
- Срабатывает событие NewInAirPackets .
- Срабатывает событие CursorDown.
- Срабатывает событие NewPackets .
- Либо создается объект IInkGesture , либо, если перемещение курсора не представляет жест, ничего не происходит.
- Срабатывает событие CursorOutOfRange .
Примечание В этом режиме принимаются одинарные или многотактные жесты. - InkAndGesture:
- Срабатывает событие CursorInRange .
- Срабатывает событие NewInAirPackets .
- Срабатывает событие CursorDown.
- Срабатывает событие NewPackets .
- Создается объект IInkGesture или объект IInkStrokeDisp .
- Срабатывает событие CursorOutOfRange .
Примечание В этом режиме принимаются только однонаводные жесты.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP Tablet PC Edition [только классические приложения] |
Минимальная версия сервера | Ни одна версия не поддерживается |
Верхняя часть | msinkaut.h |
См. также раздел
Свойство CollectionMode [класс InkCollector]