ApplicationGesture Enumeration

Article
12/12/2007

Defines values for the set of available application-specific gestures.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in microsoft.ink.dll)

Syntax

'Declaration
Public Enumeration ApplicationGesture
'Usage
Dim instance As ApplicationGesture

public enum ApplicationGesture

public enum class ApplicationGesture

public enum ApplicationGesture

public enum ApplicationGesture

Members

	Member name	Description
	AllGestures	Recognizes all application-specific gestures.
	ArrowDown	The arrow can be drawn in a single stroke or in two strokes where one stroke is the line and the other is the arrow head. Do not use more than two strokes to draw the arrow.
	ArrowLeft	The arrow can be drawn in a single stroke or in two strokes where one stroke is the line and the other is the arrow head. Do not use more than two strokes to draw the arrow.
	ArrowRight	The arrow can be drawn in a single stroke or in two strokes where one stroke is the line and the other is the arrow head. Do not use more than two strokes to draw the arrow.
	ArrowUp	The arrow can be drawn in single stroke or in two strokes where one stroke is the line and the other is the arrow head. Do not use more than two strokes to draw the arrow.
	Check	The upward stroke must be twice as long as the smaller downward stroke.
	ChevronDown	Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
	ChevronLeft	Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
	ChevronRight	Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
	ChevronUp	Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
	Circle	The circle must be drawn in a single stroke without lifting the pen.
	Curlicue	Start the curlicue where you want an action to occur.
	DoubleCircle	The two circles must overlap each other and be drawn in a single stroke without lifting the pen.
	DoubleCurlicue	Start the double-curlicue where you want an action to occur.
	DoubleTap	Signifies a mouse double-click. Tap quickly and in as close to the same place for best results.
	Down	This gesture must be drawn as a single fast flick downward. This gesture is used by Flicks Gestures.
	DownLeft	This gesture must be drawn in a single stroke starting with the down stroke. The two sides must be as equal in length as possible and at a right angle.
	DownLeftLong	This gesture must be drawn in a single stroke starting with the down stroke. The left stroke is about twice as long as the up stroke, and the two strokes must be at a right angle.
	DownRight	This gesture must be drawn in a single stroke starting with the down stroke. The two sides must be as equal in length as possible and at a right angle.
	DownRightLong	Signifies pressing the spacebar. This gesture must be drawn in a single stroke starting with the down stroke. The right stroke must be about twice as long as the up stroke, and the two strokes must be at a right angle.
	DownUp	This gesture must be drawn in a single stroke starting with the down stroke. The two strokes must be as close to each other as possible.
	Exclamation	The line must be drawn first and then the dot drawn quickly and as close to the line as possible.
	Left	This gesture must be drawn as a single fast flick to the left. This gesture is used by Flicks Gestures.
	LeftDown	This gesture must be drawn in a single stroke starting with the left stroke. The two sides are as equal in length as possible and at a right angle.
	LeftRight	This gesture must be drawn in a single stroke starting with the left stroke. The two strokes must be as close to each other as possible.
	LeftUp	This gesture must be drawn in a single stroke starting with the left stroke. The two sides must be as equal in length as possible and at a right angle.
	NoGesture	Recognizes no application-specific gestures.
	Right	This gesture must be drawn as a single fast flick to the right. This gesture is used by Flicks Gestures.
	RightDown	This gesture must be drawn in a single stroke starting with the right stroke. The two sides must be as equal in length as possible and at a right angle.
	RightLeft	This gesture must be drawn in a single stroke starting with the right stroke. The two strokes must be as close to each other as possible.
	RightUp	This gesture must be drawn in a single stroke starting with the right stroke. The two sides must be as equal in length as possible and at a right angle.
	Scratchout	This gesture must be drawn as a single stroke that has at least three back-and-forth motions.
	SemiCircleLeft	The semicircle must be drawn from left to right. The two ends of the semicircle should be as horizontally even as possible.
	SemiCircleRight	The semicircle must be drawn from right to left. The two ends of the semicircle should be as horizontally even as possible.
	Square	The square can be drawn in one or two strokes. In one stroke, draw the entire square without lifting the pen. In two strokes, draw three sides of the square and use another stroke to draw the remaining side. Do not use more than two strokes to draw the square.
	Star	The star must have exactly five points and be drawn in a single stroke without lifting the pen.
	Tap	Signifies a mouse click. For the least amount of slippage, tap quickly.
	Triangle	The triangle must be drawn in a single stroke, without lifting the pen.
	Up	This gesture must be drawn as a single fast flick in the upward direction. This gesture is used by Flicks Gestures.
	UpDown	This gesture must be drawn in a single stroke starting with the up stroke. The two strokes must be as close to each other as possible.
	UpLeft	This gesture must be drawn in a single stroke starting with the up stroke. The two sides must be as equal in length as possible and at a right angle.
	UpLeftLong	This gesture must be drawn in a single stroke starting with the up stroke. The left stroke must be about twice as long as the up stroke, and the two strokes must be at a right angle.
	UpRight	This gesture must be drawn in a single stroke starting with the up stroke. The two sides must be as equal in length as possible and at a right angle.
	UpRightLong	This gesture must be drawn in a single stroke starting with the up stroke. The right stroke must be about twice as long as the up stroke, and the two strokes must be at a right angle.

Remarks

Application gestures are gestures 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. For a list containing the shapes of the gestures and their suggested semantic behavior in an application, see Application Gestures and Semantic Behavior.

The Tap and DoubleTap gestures are supported as application gestures and system gestures (system gestures are defined in the SystemGesture 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 gestures, Microsoft intends to support many gesture glyphs as part of the Microsoft gesture recognizer. For more information about these unimplemented gesture glyphs, see Unimplemented Glyphs.

For more information about application gestures and system gestures, see Using Gestures.

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 below 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 every recognized gesture is below the suggested confidence threshold), then the platform cancels the gesture event by default; otherwise, the platform accepts the gesture by default. To alter the default behavior, capture the InkCollector.Gesture, InkOverlay.Gesture, InkPicture.Gesture, or InkEdit.Gesture event. When a gesture is accepted, the stroke is not added to the Microsoft.Ink.Ink object. When a gesture is canceled, the stroke is added to the Microsoft.Ink.Ink object.

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

Share via

ApplicationGesture Enumeration

Syntax

Members

Remarks

Platforms

Version Information

.NET Framework

See Also

Reference

Other Resources

Additional resources