Platforms to show: All Mac Windows Linux Cross-Platform
WinGestureConfigMBS class
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
class | Windows | MBS Win Plugin | 16.2 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
It is impossible to disable two-finger panning and keep single finger panning. You must set the want bits for GC_PAN before you can set them for GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY or GC_PAN_WITH_SINGLE_FINGER_VERTICALLY.
An inertia vector is included in the GID_PAN message with the GF_END flag if inertia was disabled by a call to SetGestureConfig.
When you pass this structure, the dwID member contains information for a set of gestures. This determines what the other flags will mean. If you set flags for pan messages, they will be different from those flags that are set for rotation messages.
The following table indicates the various identifiers for gestures that are supported by the dwID member of the GESTURECONFIG structure. Note that setting dwID to 0 indicates that global gesture configuration flags are set.
Name | Value | Description |
GID_ZOOM | 3 | Indicates configuration settings for the zoom gesture. |
GID_PAN | 4 | Indicates the pan gesture. |
GID_ROTATE | 5 | Indicates the rotation gesture. |
GID_TWOFINGERTAP | 6 | Indicates the two-finger tap gesture. |
GID_PRESSANDTAP | 7 | Indicates the press and tap gesture. |
The following flags are used when dwID is set to 0.
Name | Value | Description |
GC_ALLGESTURES | 0x00000001 | Indicates all of the gestures. |
The following flags are used when dwID is set to GID_ZOOM.
Name | Value | Description |
GC_ZOOM | 0x00000001 | Indicates the zoom gesture. |
The following flags are used when dwID is set to GID_PAN.
Name | Value | Description |
GC_PAN | 0x00000001 | Indicates all pan gestures. |
GC_PAN_WITH_SINGLE_FINGER_VERTICALLY | 0x00000002 | Indicates vertical pans with one finger. |
GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY | 0x00000004 | Indicates horizontal pans with one finger. |
GC_PAN_WITH_GUTTER | 0x00000008 | Limits perpendicular movement to primary direction until a threshold is reached to break out of the gutter. |
GC_PAN_WITH_INERTIA | 0x00000010 | Indicates panning with inertia to smoothly slow when pan gestures stop. |
Note Setting the GID_PAN flags in SetGestureConfig will affect the default gesture handler for panning. You should not have both dwWant and dwBlock set for the same flags; this will result in unexpected behavior. See Windows Touch Gestures for more information on panning and legacy panning support; see SetGestureConfig for examples of enabling and blocking gestures.
The following flags are used when dwID is set to GID_ROTATE.
Name | Value | Description |
GC_ROTATE | 0x00000001 | Indicates the rotation gesture. |
The following flags are used when dwID is set to GID_TWOFINGERTAP.
Name | Value | Description |
GC_TWOFINGERTAP | 0x00000001 | Indicates the two-finger tap gesture. |
The following flags are used when dwID is set to GID_PRESSANDTAP.
Name | Value | Description |
GC_PRESSANDTAP | 0x00000001 | Indicates the press and tap gesture. |
Gesture Options
Constant | Value | Description |
---|---|---|
kAllGestures | 1 |
Indicates all of the gestures. (for ID = 0) |
kPan | 1 |
Indicates all pan gestures. |
kPanWithGutter | 8 |
Limits perpendicular movement to primary direction until a threshold is reached to break out of the gutter. |
kPanWithInteria | 16 |
Indicates panning with inertia to smoothly slow when pan gestures stop. |
kPanWithSingleFingerHorizontally | 4 |
Indicates horizontal pans with one finger. |
kPanWithSingleFingerVertically | 2 |
Indicates vertical pans with one finger. |
kPressAndTap | 1 |
Indicates the press and tap gesture. |
kRotate | 1 |
Indicates the rotation gesture. |
kTwoFingerTap | 1 |
Indicates the two-finger tap gesture. |
kZoom | 1 |
Indicates the zoom gesture. (for ID = kGestureIDZoom) |
Gesture IDs
Constant | Value | Description |
---|---|---|
kGestureIDBegin | 1 |
Begin of gesture. |
kGestureIDEnd | 2 |
End of a gesture |
kGestureIDPan | 4 |
Pan gesture |
kGestureIDPressAndTap | 7 |
Press and Tap gesture |
kGestureIDRotate | 5 |
Rotate gesture |
kGestureIDTwoFingerTap | 6 |
Two-Finger Tap |
kGestureIDZoom | 3 |
Zoom gesture |
This class has no sub classes.
Some methods using this class:
- WinPointerEventsMBS.GetGestureConfig(Control as DesktopUIControl, config() as WinGestureConfigMBS, flags as Integer = 0) as Integer
- WinPointerEventsMBS.GetGestureConfig(Control as RectControl, config() as WinGestureConfigMBS, flags as Integer = 0) as Integer
- WinPointerEventsMBS.GetGestureConfig(win as DesktopWindow, config() as WinGestureConfigMBS, flags as Integer = 0) as Integer
- WinPointerEventsMBS.GetGestureConfig(win as window, config() as WinGestureConfigMBS, flags as Integer = 0) as Integer
- WinPointerEventsMBS.SetGestureConfig(Control as DesktopUIControl, config() as WinGestureConfigMBS = nil) as boolean
- WinPointerEventsMBS.SetGestureConfig(Control as RectControl, config() as WinGestureConfigMBS = nil) as boolean
- WinPointerEventsMBS.SetGestureConfig(win as DesktopWindow, config() as WinGestureConfigMBS = nil) as boolean
- WinPointerEventsMBS.SetGestureConfig(win as window, config() as WinGestureConfigMBS = nil) as boolean
Some examples using this class:
Blog Entries
Videos
The items on this page are in the following plugins: MBS Win Plugin.
WinFileTypeMBS - WinGestureInfoMBS