SystemGesture Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Defines the available system gestures.
public enum class SystemGesture
public enum SystemGesture
type SystemGesture =
Public Enum SystemGesture
- Inheritance
Fields
Name | Value | Description |
---|---|---|
None | 0 | No system gesture. |
Tap | 16 | Maps to a left-click on a mouse. This can be used to choose a command from the menu or toolbar, take action if a command is chosen, set an insertion point, or show selection feedback. |
RightTap | 18 | Maps to a right-click on a mouse. This can be used to show a shortcut menu. |
Drag | 19 | Maps to a left drag on a mouse. |
RightDrag | 20 | Maps to a right drag on a mouse. This can be used to drag an object or selection to a different area and is followed by the appearance of the shortcut menu which provides options for moving the object. |
HoldEnter | 21 | Indicates that press and hold has occurred. |
HoldLeave | 22 | Not implemented. |
HoverEnter | 23 | Maps to a mouse hover. This can be used to show ToolTip rollover effects, or other mouse hover behaviors. |
HoverLeave | 24 | Maps to a mouse leaving a hover. This can be used to end ToolTip rollover effects or other mouse hover behaviors. |
Flick | 31 | Occurs with a short, quick stroke that translates into a specific command. The action taken by a flick is set system-wide. An application can listen for a Flick and prevent it from becoming one of the standard ApplicationCommands by setting the Handled property to true in the StylusSystemGesture event. Only Windows Vista supports flicks. |
TwoFingerTap | 4352 | Maps to a double-click of a mouse. |
Examples
The following example determines which type of system gesture raised the SystemGesture event. This example assumes that there is an InkCanvas called inkcanvas1
, and that SystemGesture is connected to the following event handler.
void inkCanvas1_StylusSystemGesture(object sender, StylusSystemGestureEventArgs e)
{
this.Title = e.SystemGesture.ToString();
switch (e.SystemGesture)
{
case SystemGesture.RightTap:
// Do something.
break;
case SystemGesture.Tap:
// Do something else.
break;
}
}
Private Sub inkCanvas1_StylusSystemGesture(ByVal sender As Object, ByVal e As StylusSystemGestureEventArgs)
Me.Title = e.SystemGesture.ToString()
Select Case e.SystemGesture
Case SystemGesture.RightTap
' Do something.
Case SystemGesture.Tap
' Do something else.
End Select
End Sub
Remarks
When the operating system recognizes system gestures, the StylusSystemGesture event occurs. Many of the gestures map to traditional mouse events. For example, the Tap
system gesture mimics a single left-click on a mouse.