Énumération InkApplicationGesture (msinkaut.h)

Article
08/24/2023

Définit des valeurs qui définissent l’intérêt dans un ensemble de mouvements spécifiques à l’application.

Les mouvements d’application sont des mouvements que vous pouvez choisir pour que votre application soit prise en charge. Les applications spécifiquement conçues pour fonctionner avec un stylet sont plus susceptibles d’utiliser ces mouvements que les applications conçues pour la souris et le clavier.

Les mouvements Tap et DoubleTap sont pris en charge en tant que mouvements d’application et mouvements système (les mouvements système sont définis dans le type d’énumération InkSystemGesture ). Cela signifie que vous pouvez incorporer un mouvement d’application qui a un composant qui peut être interprété comme un mouvement Tap ou DoubleTap (comme le mouvement d’exclamation ). Dans ce cas, activez le mouvement Appuyez sur l’application et désactivez le mouvement Appuyez sur le système dans votre application. Lorsqu’un utilisateur appuie, le mouvement de l’application est reconnu. Cela permet à votre application d’écouter un seul composant qui peut à la fois identifier et distinguer un mouvement système Appuyez d’unappui dans le mouvement d’application.

En plus de la liste de mouvements suivante, Microsoft a l’intention de prendre en charge de nombreux glyphes de mouvement dans le cadre du module de reconnaissance de mouvements Microsoft. Pour plus d’informations sur ces glyphes de mouvement non implémentés, consultez Glyphes non implémentés.

Pour plus d’informations sur les mouvements d’application et les mouvements système, consultez Utilisation des mouvements et de l’entrée de stylet, de l’encre et de la reconnaissance.

Syntax

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
} ;

Constantes


`IAG_AllGestures` Valeur : 0 Tous les mouvements spécifiques à l’application.
`IAG_NoGesture` Valeur : 0xf000 Aucun mouvement spécifique à l’application. Pour plus d’informations sur ce membre, consultez la section « Remarques » suivante. Il s’agit de la valeur par défaut.
`IAG_Scratchout` Valeur : 0xf001 Ce mouvement doit être dessiné comme un seul trait qui a au moins trois déplacements dans les deux sens.
`IAG_Triangle` Valeur : 0xf002 Le triangle doit être dessiné d'un seul trait sans soulever le stylet.
`IAG_Square` Valeur : 0xf003 Le carré peut être dessiné d'un ou deux traits. D'un trait, dessinez le carré entier sans soulever le stylet. De deux traits, dessinez trois côtés du carré et utilisez un autre trait pour dessiner le côté restant. N'utilisez pas plus de deux traits pour dessiner le carré.
`IAG_Star` Valeur : 0xf004 L'étoile doit avoir exactement cinq points et être dessinée d'un seul trait sans soulever le stylet.
`IAG_Check` Valeur : 0xf005 Le trait ascendant doit être deux fois plus long que le plus petit trait descendant.
`IAG_Curlicue` Valeur : 0xf010 Démarrez le curlicue sur l’encre sur laquelle vous envisagez d’agir.
`IAG_DoubleCurlicue` Valeur : 0xf011 Démarrez le double curlicue sur l’encre sur laquelle vous envisagez d’agir.
`IAG_Circle` Valeur : 0xf020 Le cercle doit être dessiné d'un seul trait sans soulever le stylet.
`IAG_DoubleCircle` Valeur : 0xf021 Les deux cercles doivent se chevaucher l'un l'autre et être dessinés d'un seul trait sans soulever le stylet.
`IAG_SemiCircleLeft` Valeur : 0xf028 Le demi-cercle doit être dessiné de gauche à droite. Horizontalement, les deux extrémités du demi-cercle doivent être aussi homogènes que possible.
`IAG_SemiCircleRight` Valeur : 0xf029 Le demi-cercle doit être dessiné de droite à gauche. Horizontalement, les deux extrémités du demi-cercle doivent être aussi homogènes que possible.
`IAG_ChevronUp` Valeur : 0xf030 Les deux côtés du chevron doivent être dessinés de la manière la plus similaire qui soit. L'angle doit être aigu et se terminer en un point.
`IAG_ChevronDown` Valeur : 0xf031 Les deux côtés du chevron doivent être dessinés de la manière la plus similaire qui soit. L'angle doit être aigu et se terminer en un point.
`IAG_ChevronLeft` Valeur : 0xf032 Les deux côtés du chevron doivent être dessinés de la manière la plus similaire qui soit. L'angle doit être aigu et se terminer en un point.
`IAG_ChevronRight` Valeur : 0xf033 Les deux côtés du chevron doivent être dessinés de la manière la plus similaire qui soit. L'angle doit être aigu et se terminer en un point.
`IAG_ArrowUp` Valeur : 0xf038 La flèche peut être dessinée en un seul trait ou en deux traits dans lesquels un trait est la ligne et l’autre est la tête de flèche. N'utilisez pas plus de deux traits pour dessiner la flèche.
`IAG_ArrowDown` Valeur : 0xf039 La flèche peut être dessinée d’un seul trait ou de deux traits dans lesquels un trait est la ligne et l’autre est la tête de flèche. N'utilisez pas plus de deux traits pour dessiner la flèche.
`IAG_ArrowLeft` Valeur : 0xf03a La flèche peut être dessinée d’un seul trait ou de deux traits dans lesquels un trait est la ligne et l’autre est la tête de flèche. N'utilisez pas plus de deux traits pour dessiner la flèche.
`IAG_ArrowRight` Valeur : 0xf03b La flèche peut être dessinée d’un seul trait ou de deux traits dans lesquels un trait est la ligne et l’autre est la tête de flèche. N'utilisez pas plus de deux traits pour dessiner la flèche.
`IAG_Up` Valeur : 0xf058 Ce mouvemente doit être dessiné comme un raccourci rapide seul dans la direction ascendante. Ce mouvement est utilisé par les mouvements Flicks.
`IAG_Down` Valeur : 0xf059 Ce mouvemente doit être dessiné comme un raccourci rapide seul dans la direction descendante. Ce mouvement est utilisé par les mouvements Flicks.
`IAG_Left` Valeur : 0xf05a Ce mouvement doit être dessiné à gauche comme un raccourci rapide seul. Ce mouvement est utilisé par les mouvements Flicks.
`IAG_Right` Valeur : 0xf05b Ce mouvement doit être dessiné à droite comme un raccourci rapide seul. Ce mouvement est utilisé par les mouvements Flicks.
`IAG_UpDown` Valeur : 0xf060 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait supérieur. Les deux traits doivent être aussi proches que possible l'un de l'autre.
`IAG_DownUp` Valeur : 0xf061 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait inférieur. Les deux traits doivent être aussi proches que possible l'un de l'autre.
`IAG_LeftRight` Valeur : 0xf062 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait gauche. Les deux traits doivent être aussi proches que possible l'un de l'autre.
`IAG_RightLeft` Valeur : 0xf063 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait droit. Les deux traits doivent être aussi proches que possible l'un de l'autre.
`IAG_UpLeftLong` Valeur : 0xf064 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait supérieur. Le trait gauche doit être environ deux fois plus long que le trait ascendant ; les deux traits doivent être à un angle droit.
`IAG_UpRightLong` Valeur : 0xf065 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait supérieur. Le trait droit doit être environ deux fois plus long que le trait ascendant ; les deux traits doivent être à un angle droit.
`IAG_DownLeftLong` Valeur : 0xf066 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait inférieur. Le trait gauche est environ deux fois plus long que le trait ascendant ; les deux traits doivent être à un angle droit.
`IAG_DownRightLong` Valeur : 0xf067 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait inférieur. Le trait droit doit être environ deux fois plus long que le trait ascendant ; les deux traits doivent être à un angle droit.
`IAG_UpLeft` Valeur : 0xf068 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait supérieur. Les deux côtés doivent être aussi proches que possible en termes de longueur et à un angle droit.
`IAG_UpRight` Valeur : 0xf069 Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait supérieur. Les deux côtés doivent être aussi proches que possible en termes de longueur et à un angle droit.
`IAG_DownLeft` Valeur : 0xf06a Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait inférieur. Les deux côtés doivent être aussi proches que possible en termes de longueur et à un angle droit.
`IAG_DownRight` Valeur : 0xf06b Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait inférieur. Les deux côtés doivent être aussi proches que possible en termes de longueur et à un angle droit.
`IAG_LeftUp` Valeur : 0xf06c Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait gauche. Les deux côtés doivent être aussi proches que possible en termes de longueur et à un angle droit.
`IAG_LeftDown` Valeur : 0xf06d Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait gauche. Les deux côtés sont aussi proches que possible en termes de longueur et à un angle droit.
`IAG_RightUp` Valeur : 0xf06e Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait droit. Les deux côtés doivent être aussi proches que possible en termes de longueur et à un angle droit.
`IAG_RightDown` Valeur : 0xf06f Ce mouvement doit être dessiné d'un seul trait, en commençant par le trait droit. Les deux côtés doivent être aussi proches que possible en termes de longueur et à un angle droit.
`IAG_Exclamation` Valeur : 0xf0a4 La ligne doit être dessinée en premier, puis le point dessiné rapidement et aussi proche de la ligne que possible.
`IAG_Tap` Valeur : 0xf0f0 Un clic de souris. Pour le moins de glissement sur la surface du numériseur, appuyez rapidement.
`IAG_DoubleTap` Valeur : 0xf0f1 Double-cliquez sur la souris. Appuyez rapidement et en tant que proche du même endroit pour obtenir de meilleurs résultats.

Notes

La valeur par défaut est NoGesture, qui est en fait une ligne de limite qui représente la confiance suggérée minimale du module de reconnaissance de gestes Microsoft. Il ne représente pas réellement un mouvement ou un manque de mouvement, mais simplement le point auquel l’outil de reconnaissance de mouvement manque suffisamment de confiance dans la précision du résultat pour recommander tout ce qui suit ce point.

Par exemple, supposons qu’un tableau de mouvements se compose des valeurs suivantes : Circle, LeftRight, NoGesture, RightLeft et Triangle. Dans ce cas, le gest recognizer a un grand degré de confiance en Circle et moins confiance dans LeftRight. Le module de reconnaissance a très peu de confiance dans RightLeft et Triangle , car ils viennent après NoGesture dans l’ordre du tableau.

Le niveau de confiance auquel le module de reconnaissance de mouvements retourne NoGesture ne peut pas être modifié.

Si NoGesture est le premier élément du tableau (ce qui signifie que chaque mouvement reconnu est inférieur au seuil de confiance suggéré), la plateforme modifie la valeur par défaut du paramètre Cancel dans le gestionnaire d’événements Gesture de FALSE à TRUE. Cela fait que l’encre est considérée comme un trait et qu’elle n’est pas supprimée de l’objet InkDisp par défaut.

Spécifications


Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
En-tête	msinkaut.h