Событие InkCollector.SystemGesture

Статья
06/13/2023

Происходит при распознавании системного жеста.

Синтаксис

void SystemGesture(
  [in] IInkCursor       *Cursor,
  [in] InkSystemGesture Id,
  [in] long             X,
  [in] long             Y,
  [in] long             Modifier,
  [in] BSTR             Character,
  [in] long             CursorMode
);

Параметры

Курсор [в]: Объект IInkCursor , создающий событие SystemGesture .
Идентификатор [in]: Значение системного жеста.
X [in]: Координата по оси X расположения жеста.
Y [in]: Координата Y расположения жеста.
Модификатор [in]: Зарезервировано.
Символ [in]: Зарезервировано.
CursorMode [in]: Значение типа , указывающее, находится ли объект IInkCursor в обычном режиме или в режиме ластика. 1 — для обычного режима, а 2 — для режима ластика.

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

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

Системные жесты полезны, так как они предоставляют сведения об объекте IInkCursor , который используется для создания жеста. Они также предоставляют сочетания сочетаний событий мыши и являются "более дешевыми" способами обнаружения событий мыши.

Например, вместо того, чтобы искать пару событий MouseUp / MouseDown , между которыми не происходят другие события мыши, можно найти системные жесты Tap или RightTap .

Другой пример: вместо того, чтобы прослушивать события MouseDown Событие / MouseMove и получать многочисленные сообщения о событиях MouseMove, можно watch для системных жестов Перетаскивание или RightDrag, если вас не интересуют координаты (x, y) каждой позиции мыши. Это позволяет получать только одно сообщение вместо многочисленных сообщений о событиях MouseMove .

Список определенных системных жестов см. в разделе Тип перечисления InkSystemGesture . Дополнительные сведения о системных жестах см. в разделе Использование жестов и командного ввода на планшетном компьютере.

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

Требования

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

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

Класс InkCollector
Перечисление InkSystemGesture
Интерфейс IInkCursor
Использование жестов
Ввод, рукописный ввод и распознавание с помощью пера
Ввод команд на планшетном компьютере