Метод IInkOverlay::p ut_CollectionMode (msinkaut.h)

Статья
08/24/2023

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

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT put_CollectionMode(
  InkCollectionMode Mode
);

Параметры

Mode

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

None

Remarks

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

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

Для каждого из значений CollectionMode возникает следующее поведение:

Режим InkOnly

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

Режим GestureOnly

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

Режим InkAndGesture

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

Изменение режима сбора не изменяет состояние отдельных жестов.

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

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

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

Требования

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

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

Свойство CollectingInk

Свойство Enabled

IInkOverlay

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

Класс InkOverlay

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