Поделиться через

Метод IInkCollector::get_CollectionMode (msinkaut.h)

  • Статья

Получает или задает режим сбора, определяющий, распознаются ли рукописные фрагменты, жесты или и то, и другое.

Это свойство является чтением и записью.

Синтаксис

HRESULT get_CollectionMode(
  InkCollectionMode *Mode
);

Параметры

Mode

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

None

Remarks

Список режимов, которые можно использовать, см. в разделе Тип перечисления InkCollectionMode . Однако при использовании свойства CollectionMode в системе с установленным пакетом средств разработки программного обеспечения (SDK) Microsoft Windows XP Tablet PC Edition, но не установленным распознавателям, нельзя установить режим GestureOnly или InkAndGesture.

Примечание Объект InkCollector , объект InkOverlay или элемент управления InkPicture создает ошибку при попытке изменить свойство CollectionMode во время сбора рукописного ввода. Чтобы избежать этого конфликта, проверка свойство CollectionInk перед изменением свойства CollectionMode.
 
Для каждого из значений CollectionMode возникает следующее поведение:

Режим InkOnly

  • Собирается только рукописный ввод; жесты не являются.
  • Для интереса события Жест задано значение FALSE (все остальные интересы событий остаются прежними).

Режим GestureOnly

  • Собираются только жесты; рукописный ввод не является. Штрихи удаляются после их отправки в распознаватель жестов.
  • Для интереса события Жест задано значение TRUE (все остальные интересы событий остаются прежними).
  • Сборщик рукописного ввода не запускает следующие события, связанные с штрихами и пакетами: CursorDown, Stroke, NewPackets и NewInAirPackets .
  • События курсора активит.
  • Рукописный ввод всегда удаляется.

Режим InkAndGesture

  • Собираются как рукописные фрагменты, так и жесты.
  • Распознаются только жесты с одним росчерком.
  • Для интереса события Жест задано значение TRUE (все остальные интересы событий остаются прежними).
  • Сначала запускается событие Жест , что позволяет принять или отменить жест. Чтобы отменить жест, задайте для параметра Cancel значение TRUE. Отмена жеста заставляет сборщик рукописного ввода собирать рукописные фрагменты.
Изменение режима сбора не изменяет состояние отдельных жестов.

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

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

  1. Задайте для свойства CollectionModeзначение InkAndGesture.
  2. В событии Stroke удалите росчерк.
  3. В событии Жест обработайте жест.
  4. Установите для DynamicRenderingзначение FALSE , чтобы предотвратить поток рукописного ввода во время жестикулирования.

Требования

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

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

Свойство CollectingInk

Свойство Enabled

IInkCollector

Перечисление InkCollectionMode

Класс InkCollector