Событие InkPicture.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 [InkPicture Control]/MouseDown Event [InkPicture Control] без каких-либо других событий мыши между ними, можно найти системные жесты Tap или RightTap.

В качестве другого примера вместо прослушивания событий MouseDown [inkPicture Control]/MouseMove Event [InkPicture Control] и получения многочисленных сообщений MouseMove Event [InkPicture Control] можно watch для системных жестов Перетаскивания или RightDrag, если вы не заинтересованы в координатах (x, y) каждой позиции мыши. Это позволяет получать только одно сообщение вместо многочисленных сообщений MouseMove Event [InkPicture Control] .

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

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

Требования

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

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

InkPicture
Перечисление InkSystemGesture
Использование жестов