Перечисление 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, можно:

При использовании этого перечисления с элементом управления InkPicture (или объектами InkCollector или InkOverlay ) в системе с установленным пакетом средств разработки программного обеспечения (SDK) Microsoft Windows XP Tablet PC Edition, но у которого нет распознавателей, режим не может быть установлен на GestureOnly или InkAndGesture.

Сборщик рукописного ввода всегда создает росчерк (режим InkOnly) или жест (режим GestureOnly), а иногда и оба (режим InkAndGesture).

Ниже приведены типичные сценарии для каждого режима.

Нежелательное поведение может возникать, если свойству CollectionMode присвоено значение InkAndGesture и задан интерес объекта или элемента управления в известном жесте (путем вызова метода SetGestureStatus ). Если пользователь рисует рукописный ввод, похожий на жест, который находится в списке вариантов распознавания распознавателя, событие Жест срабатывает и рукописный ввод исчезает, даже если жест не является верхним вариантом. Чтобы предотвратить исчезновение рукописного ввода и отменить сбор жеста, установите для параметра Отмена значение TRUE , если событие является событием, на которое не требуется отвечать распознаватель.

Требования

Требование Значение
Минимальная версия клиента Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Верхняя часть msinkaut.h

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

Свойство CollectionMode [класс InkCollector]

Событие жеста

Класс InkCollector

Класс InkOverlay

Справочник по элементу управления InkPicture

Событие stroke