Перечисление InkApplicationGesture (msinkaut.h)

Статья
03/08/2023

Определяет значения, которые задают интерес в наборе жестов для конкретного приложения.

Жесты приложения — это жесты, которые можно выбрать для поддержки приложения. Приложения, специально предназначенные для работы с пером, чаще используют эти жесты, чем приложения, предназначенные для работы с мышью и клавиатурой.

Жесты Tap и DoubleTap поддерживаются в качестве жестов приложения и системных жестов (системные жесты определяются в типе перечисления InkSystemGesture ). Это означает, что вы можете включить жест приложения с компонентом, который может быть истолковано как tap или doubleTap (например, восклицательный жест). В этом случае включите жест касания приложения и отключите системный жест Tap в приложении. Когда пользователь касается, распознается жест приложения. Это позволяет приложению прослушивать один компонент, который может идентифицировать и отличать системный жест Касание от касания в жесте приложения.

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

Дополнительные сведения о жестах приложения и системных жестах см. в статье Использование жестов и ввода пером, рукописного ввода и распознавания.

Синтаксис

typedef enum InkApplicationGesture {
  IAG_AllGestures = 0,
  IAG_NoGesture = 0xf000,
  IAG_Scratchout = 0xf001,
  IAG_Triangle = 0xf002,
  IAG_Square = 0xf003,
  IAG_Star = 0xf004,
  IAG_Check = 0xf005,
  IAG_Curlicue = 0xf010,
  IAG_DoubleCurlicue = 0xf011,
  IAG_Circle = 0xf020,
  IAG_DoubleCircle = 0xf021,
  IAG_SemiCircleLeft = 0xf028,
  IAG_SemiCircleRight = 0xf029,
  IAG_ChevronUp = 0xf030,
  IAG_ChevronDown = 0xf031,
  IAG_ChevronLeft = 0xf032,
  IAG_ChevronRight = 0xf033,
  IAG_ArrowUp = 0xf038,
  IAG_ArrowDown = 0xf039,
  IAG_ArrowLeft = 0xf03a,
  IAG_ArrowRight = 0xf03b,
  IAG_Up = 0xf058,
  IAG_Down = 0xf059,
  IAG_Left = 0xf05a,
  IAG_Right = 0xf05b,
  IAG_UpDown = 0xf060,
  IAG_DownUp = 0xf061,
  IAG_LeftRight = 0xf062,
  IAG_RightLeft = 0xf063,
  IAG_UpLeftLong = 0xf064,
  IAG_UpRightLong = 0xf065,
  IAG_DownLeftLong = 0xf066,
  IAG_DownRightLong = 0xf067,
  IAG_UpLeft = 0xf068,
  IAG_UpRight = 0xf069,
  IAG_DownLeft = 0xf06a,
  IAG_DownRight = 0xf06b,
  IAG_LeftUp = 0xf06c,
  IAG_LeftDown = 0xf06d,
  IAG_RightUp = 0xf06e,
  IAG_RightDown = 0xf06f,
  IAG_Exclamation = 0xf0a4,
  IAG_Tap = 0xf0f0,
  IAG_DoubleTap = 0xf0f1
} ;

Константы


`IAG_AllGestures` Значение: 0 Все жесты для конкретного приложения.
`IAG_NoGesture` Значение: 0xf000 Нет жестов для конкретного приложения. Дополнительные сведения об этом члене см. в разделе "Примечания". Это значение по умолчанию.
`IAG_Scratchout` Значение: 0xf001 Этот жест необходимо изображать одним росчерком, содержащим как минимум три движения туда и обратно.
`IAG_Triangle` Значение: 0xf002 Треугольник должен быть изображен единственным росчерком, без поднятия пера.
`IAG_Square` Значение: 0xf003 Квадрат можно рисовать одним или двумя росчерками. Одним росчерком весь квадрат рисуется без отрыва пера. Двумя росчерками квадрат рисуется так: одним росчерком рисуется три стороны квадрата, а вторым — оставшаяся сторона. Не следует рисовать квадрат более чем двумя росчерками.
`IAG_Star` Значение: 0xf004 У звезды должно быть ровно пять лучей, ее необходимо рисовать одним росчерком, не отрывая пера.
`IAG_Check` Значение: 0xf005 Направленный вверх росчерк должен быть вдвое длиннее меньшего, направленного вниз росчерка.
`IAG_Curlicue` Значение: 0xf010 Запустите curlicue на рукописном фрагменте, с которым вы планируете выполнить действия.
`IAG_DoubleCurlicue` Значение: 0xf011 Запустите двойную кривую на рукописном фрагменте, с которым вы планируете выполнить действия.
`IAG_Circle` Значение: 0xf020 Круг должен быть изображен единственным росчерком, без поднятия пера.
`IAG_DoubleCircle` Значение: 0xf021 Два круга должны накладываться друг на друга и должны быть отрисованы единственным росчерком, не отрывая пера.
`IAG_SemiCircleLeft` Значение: 0xf028 Полукруг необходимо рисовать слева направо. По горизонтали два конца полукругова должны быть как можно более ровным.
`IAG_SemiCircleRight` Значение: 0xf029 Полукруг необходимо рисовать справа налево. По горизонтали два конца полукругова должны быть как можно более ровным.
`IAG_ChevronUp` Значение: 0xf030 Обе стороны кавычки-шеврона должны быть изображены как можно более похожими друг на друга. Угол должен быть острым и должен заканчиваться точкой.
`IAG_ChevronDown` Значение: 0xf031 Обе стороны кавычки-шеврона должны быть изображены как можно более похожими друг на друга. Угол должен быть острым и должен заканчиваться точкой.
`IAG_ChevronLeft` Значение: 0xf032 Обе стороны кавычки-шеврона должны быть изображены как можно более похожими друг на друга. Угол должен быть острым и должен заканчиваться точкой.
`IAG_ChevronRight` Значение: 0xf033 Обе стороны кавычки-шеврона должны быть изображены как можно более похожими друг на друга. Угол должен быть острым и должен заканчиваться точкой.
`IAG_ArrowUp` Значение: 0xf038 Стрелка может быть нарисована одним росчерком или двумя штрихами, в которых один штрих является линией, а другой — головой стрелки. Не следует рисовать стрелу более чем двумя росчерками.
`IAG_ArrowDown` Значение: 0xf039 Стрелка может быть нарисована одним штрихом или двумя штрихами, в которых один штрих является линией, а другой — стрелкой. Не следует рисовать стрелу более чем двумя росчерками.
`IAG_ArrowLeft` Значение: 0xf03a Стрелка может быть нарисована одним штрихом или двумя штрихами, в которых один штрих является линией, а другой — стрелкой. Не следует рисовать стрелу более чем двумя росчерками.
`IAG_ArrowRight` Значение: 0xf03b Стрелка может быть нарисована одним штрихом или двумя штрихами, в которых один штрих является линией, а другой — стрелкой. Не следует рисовать стрелу более чем двумя росчерками.
`IAG_Up` Значение: 0xf058 Этот жест необходимо производить как один быстрый росчерк, направленный вверх. Этот жест используется жестами Flicks.
`IAG_Down` Значение: 0xf059 Этот жест необходимо производить как один быстрый росчерк, направленный вниз. Этот жест используется жестами Flicks.
`IAG_Left` Значение: 0xf05a Этот жест необходимо производить как один быстрый штрих, направленный влево. Этот жест используется жестами Flicks.
`IAG_Right` Значение: 0xf05b Этот жест необходимо производить как один быстрый штрих, направленный вправо. Этот жест используется жестами Flicks.
`IAG_UpDown` Значение: 0xf060 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вверх. Черты должны находиться как можно ближе друг к другу.
`IAG_DownUp` Значение: 0xf061 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вниз. Черты должны находиться как можно ближе друг к другу.
`IAG_LeftRight` Значение: 0xf062 Этот жест необходимо изображать единственным росчерком, начинающимся с движения влево. Черты должны находиться как можно ближе друг к другу.
`IAG_RightLeft` Значение: 0xf063 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вправо. Черты должны находиться как можно ближе друг к другу.
`IAG_UpLeftLong` Значение: 0xf064 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вверх. Направленная влево черта должна быть приблизительно вдвое длиннее вертикальной, а угол между двумя чертами должен быть прямым.
`IAG_UpRightLong` Значение: 0xf065 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вверх. Направленная вправо черта должна быть приблизительно вдвое длиннее вертикальной, а угол между двумя чертами должен быть прямым.
`IAG_DownLeftLong` Значение: 0xf066 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вниз. Направленная влево черта должна быть приблизительно вдвое длиннее вертикальной, а угол между двумя чертами должен быть прямым.
`IAG_DownRightLong` Значение: 0xf067 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вниз. Направленная вправо черта должна быть приблизительно вдвое длиннее вертикальной, а угол между двумя чертами должен быть прямым.
`IAG_UpLeft` Значение: 0xf068 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вверх. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_UpRight` Значение: 0xf069 Этот жест необходимо изображать единственным росчерком, начинающимся с движения вверх. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_DownLeft` Значение: 0xf06a Этот жест необходимо изображать единственным росчерком, начинающимся с движения вниз. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_DownRight` Значение: 0xf06b Этот жест необходимо изображать единственным росчерком, начинающимся с движения вниз. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_LeftUp` Значение: 0xf06c Этот жест необходимо изображать единственным росчерком, начинающимся с движения влево. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_LeftDown` Значение: 0xf06d Этот жест необходимо изображать единственным росчерком, начинающимся с движения влево. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_RightUp` Значение: 0xf06e Этот жест необходимо изображать единственным росчерком, начинающимся с движения вправо. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_RightDown` Значение: 0xf06f Этот жест необходимо изображать единственным росчерком, начинающимся с движения вправо. Длина двух сторон должна различаться как можно меньше, они должны находиться под прямым углом.
`IAG_Exclamation` Значение: 0xf0a4 Сначала необходимо нарисовать линию, а затем точку, быстро и как можно ближе к линии.
`IAG_Tap` Значение: 0xf0f0 Щелчок мышью. Для наименьшего количества скольжения по поверхности дигитайзера нажмите быстро.
`IAG_DoubleTap` Значение: 0xf0f1 Двойной щелчок мыши. Коснитесь быстро и близко к тому же месту, чтобы получить наилучшие результаты.

Значение по умолчанию — NoGesture, которое на самом деле представляет собой линию отсечения, представляющую минимальную достоверность распознавателя жестов Майкрософт. На самом деле он не представляет собой жест или отсутствие жеста, просто точка, в которой распознаватель жестов не имеет достаточной уверенности в точности результата, чтобы рекомендовать что-либо после этого.

Например, предположим, что массив жестов состоит из следующих значений: Circle, LeftRight, NoGesture, RightLeft и Triangle. В этом случае распознаватель жестов имеет большую степень доверия к Circle и меньшую уверенность в LeftRight. Распознаватель имеет очень низкую уверенность в RightLeft и Triangle , так как они идут после NoGesture в порядке массива.

Невозможно изменить уровень достоверности, при котором распознаватель жестов возвращает NoGesture .

Если NoGesture является первым элементом в массиве (что означает, что каждый распознаваемый жест ниже предлагаемого порога достоверности), платформа изменяет значение по умолчанию параметра Cancel в обработчике событий Жест с FALSE на TRUE. Это приводит к тому, что рукописный фрагмент считается росчерком и по умолчанию не удаляется из объекта InkDisp .

Требования


Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Верхняя часть	msinkaut.h