ApplicationGesture Enumeration

Article
10/16/2006

ApplicationGesture Enumeration

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

Definition

Visual Basic .NET Public Enum ApplicationGesture

C# public enum ApplicationGesture

Managed C++ __value public enum ApplicationGesture

Constants

Constant Name Description

AllGestures Recognizes all application-specific gestures.

NoGesture Recognizes no application-specific gestures.

Scratchout Erases content. This gesture requires at least three strokes in a back-and-forth direction.

Triangle Inserts input. The triangle must be drawn in a single stroke, without lifting the pen.

Square Marks an action item. 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 Marks an action item. The star must have exactly five points and be drawn in a single stroke without lifting the pen.

Check Denotes a check-off. The upward stroke must be twice as long as the smaller downward stroke.

Curlicue Cuts a word. Start the curlicue on the word you intend to cut.

DoubleCurlicue Copies a word. Start the double-curlicue on the word you intend to copy.

Circle Has no suggested semantic behavior or action. The circle must be drawn in a single stroke without lifting the pen.

DoubleCircle Pastes a selection. The two circles must overlap each other and be drawn in a single stroke without lifting the pen.

SemiCircleLeft Undoes an action. The semicircle must be drawn from left to right. The two ends of the semicircle should be as horizontally even as possible .

SemiCircleRight Redoes an action. The semicircle must be drawn from right to left. The two ends of the semicircle should be as horizontally even as possible.

ChevronUp Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.

ChevronDown Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.

ChevronLeft Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.

ChevronRight Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.

ArrowUp Has no suggested semantic behavior or action. 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.

ArrowDown Has no suggested semantic behavior or action. 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 Has no suggested semantic behavior or action. 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 Has no suggested semantic behavior or action. 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.

Up Has no suggested semantic behavior or action. This gesture must be drawn as a single fast flick in the upward direction.

Down Has no suggested semantic behavior or action. This gesture must be drawn as a single fast flick in the downward direction.

Left Specifies a backspace. This gesture must be drawn as a single fast flick to the left.

Right Signifies a space. This gesture must be drawn as a single fast flick to the right.

UpDown Undoes an action. 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.

DownUp Has no suggested semantic behavior or action. 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.

LeftRight Cuts a selection. 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.

RightLeft Copies a selection. 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.

UpLeftLong Decreases the indent. 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.

UpRightLong Signifies pressing a TAB key. 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.

DownLeftLong Signifies pressing an ENTER key. 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.

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.

UpLeft Has no suggested semantic behavior or action. 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.

UpRight Has no suggested semantic behavior or action. 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.

DownLeft Has no suggested semantic behavior or action. 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.

DownRight Has no suggested semantic behavior or action. 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.

LeftUp Has no suggested semantic behavior or action. 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.

LeftDown Has no suggested semantic behavior or action. 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.

RightUp Signifies an Input Method Editor (IME) convert. 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.

RightDown Has no suggested semantic behavior or action. 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.

Exclamation Has no suggested semantic behavior or action. The line must be drawn first and then the dot drawn quickly and as close to the line as possible.

Tap Signifies a mouse click. For the least amount of slippage, the tap must be made quickly.

DoubleTap Signifies a mouse double-click. The two taps must be made quickly to result in the least amount of slippage and the least duration between taps. In addition, the taps must be as close to each other as possible.

Constant Name	Description
AllGestures	Recognizes all application-specific gestures.
NoGesture	Recognizes no application-specific gestures.
Scratchout	Erases content. This gesture requires at least three strokes in a back-and-forth direction.
Triangle	Inserts input. The triangle must be drawn in a single stroke, without lifting the pen.
Square	Marks an action item. 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	Marks an action item. The star must have exactly five points and be drawn in a single stroke without lifting the pen.
Check	Denotes a check-off. The upward stroke must be twice as long as the smaller downward stroke.
Curlicue	Cuts a word. Start the curlicue on the word you intend to cut.
DoubleCurlicue	Copies a word. Start the double-curlicue on the word you intend to copy.
Circle	Has no suggested semantic behavior or action. The circle must be drawn in a single stroke without lifting the pen.
DoubleCircle	Pastes a selection. The two circles must overlap each other and be drawn in a single stroke without lifting the pen.
SemiCircleLeft	Undoes an action. The semicircle must be drawn from left to right. The two ends of the semicircle should be as horizontally even as possible .
SemiCircleRight	Redoes an action. The semicircle must be drawn from right to left. The two ends of the semicircle should be as horizontally even as possible.
ChevronUp	Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
ChevronDown	Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
ChevronLeft	Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
ChevronRight	Has no suggested semantic behavior or action. Both sides of the chevron must be drawn as equal as possible. The angle must be sharp and end in a point.
ArrowUp	Has no suggested semantic behavior or action. 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.
ArrowDown	Has no suggested semantic behavior or action. 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	Has no suggested semantic behavior or action. 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	Has no suggested semantic behavior or action. 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.
Up	Has no suggested semantic behavior or action. This gesture must be drawn as a single fast flick in the upward direction.
Down	Has no suggested semantic behavior or action. This gesture must be drawn as a single fast flick in the downward direction.
Left	Specifies a backspace. This gesture must be drawn as a single fast flick to the left.
Right	Signifies a space. This gesture must be drawn as a single fast flick to the right.
UpDown	Undoes an action. 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.
DownUp	Has no suggested semantic behavior or action. 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.
LeftRight	Cuts a selection. 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.
RightLeft	Copies a selection. 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.
UpLeftLong	Decreases the indent. 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.
UpRightLong	Signifies pressing a TAB key. 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.
DownLeftLong	Signifies pressing an ENTER key. 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.
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.
UpLeft	Has no suggested semantic behavior or action. 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.
UpRight	Has no suggested semantic behavior or action. 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.
DownLeft	Has no suggested semantic behavior or action. 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.
DownRight	Has no suggested semantic behavior or action. 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.
LeftUp	Has no suggested semantic behavior or action. 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.
LeftDown	Has no suggested semantic behavior or action. 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.
RightUp	Signifies an Input Method Editor (IME) convert. 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.
RightDown	Has no suggested semantic behavior or action. 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.
Exclamation	Has no suggested semantic behavior or action. The line must be drawn first and then the dot drawn quickly and as close to the line as possible.
Tap	Signifies a mouse click. For the least amount of slippage, the tap must be made quickly.
DoubleTap	Signifies a mouse double-click. The two taps must be made quickly to result in the least amount of slippage and the least duration between taps. In addition, the taps must be as close to each other as possible.

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.

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 Making Windows Work with a Pen.

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 Ink object. When a gesture is canceled, the stroke is added to the Ink object.

Enumeration Information

Namespace Microsoft.Ink

Assembly Microsoft.Ink (microsoft.ink.dll)

Strong Name Microsoft.Ink, Version=1.7.4009.0, Culture=neutral, PublicKeyToken=a2870d9cc4d021c8

Visual Basic .NET	Public Enum ApplicationGesture
C#	public enum ApplicationGesture
Managed C++	__value public enum ApplicationGesture

Namespace	Microsoft.Ink
Assembly	Microsoft.Ink (microsoft.ink.dll)
Strong Name	Microsoft.Ink, Version=1.7.4009.0, Culture=neutral, PublicKeyToken=a2870d9cc4d021c8

ApplicationGesture Enumeration

ApplicationGesture Enumeration

Additional resources