Событие InkCollector.NewInAirPackets

Статья
06/13/2023

Происходит при просмотре пакета в воздухе.

Синтаксис

void NewInAirPackets(
  [in]      IInkCursor *Cursor,
  [in]      long       PacketCount,
  [in, out] VARIANT    *PacketData
);

Параметры

Курсор [in]

Объект IInkCursor , создающий событие NewInAirPackets .

PacketCount [in]

Количество полученных пакетов в воздухе.

PacketData [вход, выход]

При возврате этим методом содержит массив, содержащий выбранные данные для пакета.

Дополнительные сведения о структуре VARIANT см. в разделе Использование библиотеки COM.

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

Это событие не возвращает значение.

Пакет в воздухе создается, когда пользователь перемещает перо рядом с планшетом, а курсор находится в окне объекта сборщика рукописного ввода или пользователь перемещает мышь в связанном окне объекта сборщика рукописного ввода. События NewInAirPackets создаются быстро, а обработчик событий должен быть быстрым или снизить производительность.

Этот метод события определяется в интерфейсах _IInkCollectorEvents, _IInkOverlayEvents и _IInkPictureEvents только для диспетчеризации (dispinterfaces) с идентификатором DISPID_ICENewInAirPackets.

Событие NewInAirPackets запускается даже в режиме выбора или стирания, а не только при вставке рукописного ввода. Для этого необходимо отслеживать режим редактирования (за настройку которого вы отвечаете) и учитывать режим перед интерпретацией события. Преимущество этого требования заключается в большей свободе инноваций на платформе благодаря большей осведомленности о событиях платформы.

Чтобы задать свойства, содержащиеся в этом массиве, используйте свойство DesiredPacketDescription объекта сборщика рукописного ввода. Массив, возвращаемый параметром PacketData , содержит данные для этих свойств.

Примечание

Хотя вы можете изменить данные пакета, эти изменения не сохраняются и не используются.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Заголовок	Msinkaut.h (также требуется Msinkaut_i.c)
Библиотека	InkObj.dll

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

Класс InkCollector
Свойство DesiredPacketDescription
Событие NewPackets
Интерфейс IInkCursor

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