InkApplicationGesture Enumeration

Defines values that set the interest in a set of application-specific gestures.

Application Gestures are gestures that you can choose to have your application support. Applications that are specifically designed to work with a pen are more likely to use these gestures.

The Tap and DoubleTap gestures are supported as application gestures and system gestures (system gestures are defined in the InkSystemGesture enumeration type). This means you can incorporate an application gesture that has a component that may be construed as a Tap or DoubleTap (such as the Exclamation gesture). In this case, enable the Tap application gesture and disable the Tap system gesture in your application. When a user taps, the application gesture is recognized. This allows your application to listen for a single component that can both identify and distinguish a Tap from a Tap within the application gesture.

In addition to the following list of gestures, Microsoft® intends to support many gesture glyphs as part of the Microsoftgesture recognizer. For more information about these unimplemented gesture glyphs, see Unimplemented Glyphs.

For more information about application gestures and system gestures, see Making Windows Work with a Pen.

Declaration

[C++]

typedef enum InkApplicationGesture {
    IAG_AllGestures = 0x000,
    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
} InkApplicationGesture;

[Microsoft Visual Basic® 6.0]

Enum InkApplicationGesture
    IAG_AllGestures = 0
    IAG_NoGesture = &Hf000
    IAG_Scratchout = &Hf001
    IAG_Triangle = &Hf002
    IAG_Square = &Hf003
    IAG_Star = &Hf004
    IAG_Check = &Hf005
    IAG_Curlicue = &Hf010
    IAG_DoubleCurlicue = &Hf011
    IAG_Circle = &Hf020
    IAG_DoubleCircle = &Hf021
    IAG_SemiCircleLeft = &Hf028
    IAG_SemiCircleRight = &Hf029
    IAG_ChevronUp = &Hf030
    IAG_ChevronDown = &Hf031
    IAG_ChevronLeft = &Hf032
    IAG_ChevronRight = &Hf033
    IAG_ArrowUp = &Hf038
    IAG_ArrowDown = &Hf039
    IAG_ArrowLeft = &Hf03a
    IAG_ArrowRight = &Hf03b
    IAG_Up = &Hf058
    IAG_Down = &Hf059
    IAG_Left = &Hf05a
    IAG_Right = &Hf05b
    IAG_UpDown = &Hf060
    IAG_DownUp = &Hf061
    IAG_LeftRight = &Hf062
    IAG_RightLeft = &Hf063
    IAG_UpLeftLong = &Hf064
    IAG_UpRightLong = &Hf065
    IAG_DownLeftLong = &Hf066
    IAG_DownRightLong = &Hf0676
    IAG_UpLeft = &Hf068
    IAG_UpRight = &Hf069
    IAG_DownLeft = &Hf06a
    IAG_DownRight = &Hf06b
    IAG_LeftUp = &Hf06c
    IAG_LeftDown = &Hf06d
    IAG_RightUp = &Hf06e
    IAG_RightDown = &Hf06f
    IAG_Exclamation = &Hf0a4
    IAG_Tap = &Hf0f0
    IAG_DoubleTap = &Hf0f1
End Enum

Members

Remarks

The default value is NoGesture, which is actually a cutoff line that represents the gesture recognizer's minimum suggested confidence. It does not actually represent a gesture or lack of gesture, just the point at which the gesture recognizer lacks enough confidence in the result accuracy to recommend anything following that point.

For example, assume that a gesture array consists of the following values: Circle, LeftRight, NoGesture, RightLeft, and Triangle. In this case, the gesture recognizer has a great degree of confidence in Circle and less confidence in LeftRight. The recognizer has very low confidence in RightLeft and Triangle because they come after NoGesture in the array order.

The confidence level at which the gesture recognizer returns NoGesture cannot be changed.

If NoGesture is the first element in the array (which means that every recognized gesture is below the suggested confidence threshold), then the platform alters the default value of the Cancel parameter in the Gesture event handler from False to True. This causes the ink to be considered a stroke and not be deleted from the InkDisp object by default.

Related Topics

• InkCollector Object (Automation Library Reference)
• InkOverlay Object (Automation Library Reference)
• InkEdit Control (Automation Library Reference)
• InkPicture Control (Automation Library Reference)
• CollectionMode Property
• Design Considerations for Gestures
• Gesture Event
• Gesture Event [InkEdit Control]
• Gestures
• GetGestureStatus Method
• GetGestureStatus Method [InkEdit Control]
• GetHotPoint Method
• Making Windows Work with a Pen
• SetGestureStatus Method
• SetGestureStatus Method [InkEdit Control]
• SystemGesture Enumeration
• SystemGesture Event
• Using Gestures