Get Gesture Information (Compact 2013)

Article
11/09/2017

3/26/2014

When a gesture event occurs, GWES sends a gesture message to all the windows that you specified in calls to EnableGestures to enable the gesture type.

You call GetGestureInfo, a function provided by the gesture core, to get information about the event. You pass the handle that is in member lparam of the gesture message, and you pass a pointer to a GESTUREINFO structure. GetGestureInfo places the gesture event information in the structure.

The gesture core API definitions are in Winuser.h. The following code is the definition of GESTUREINFO.

typedef struct tagGESTUREINFO
{
    UINT cbSize;                /* Initialised to structure size */
    DWORD dwFlags;              /* Gesture Flags */
    DWORD dwID;                 /* Gesture ID */
    HWND hwndTarget;            /* HWND of target window */
    POINTS ptsLocation;         /* Coordinates of start of gesture */
    DWORD dwInstanceID;         /* Gesture Instance ID */
    DWORD dwSequenceID;         /* Gesture Sequence ID */
    ULONGLONG ullArguments;     /* Arguments specific to gesture */
    UINT cbExtraArguments;      /* Size of extra arguments in bytes */
} GESTUREINFO, * PGESTUREINFO;

Member dwFlags is a bitmap that holds gesture flags. The following table shows the flags and their meanings.

Flag	Meaning when flag is set
GF_BEGIN	The gesture started.
GF_INERTIA	A pan gesture has transitioned to a flick gesture.
GF_END	The gesture ended.
GF_SYMMETRIC	The gesture is a two-finger gesture from a symmetric panel.

For a tap (select) gesture, both GF_BEGIN and GF_END are set.

Member dwID provides the gesture type. The following table describes the gesture types.

Gesture type	Description
GID_BEGIN	The user began a touch gesture by touching the screen.
GID_END	The user ended a gesture by removing their finger from the screen.
GID_PAN	The user touched the screen (generating an earlier GID_BEGIN event) and moved their finger.
GID_ROTATE	Reserved.
GID_SCROLL	The user touched the screen, moved their finger quickly, and lifted it. This gesture is often called a flick.
GID_HOLD	The user touched the screen and held it there for longer than the hold time-out period. A hold corresponds to a mouse right-click.
GID_SELECT	The user touched the screen and held it there for shorter than the hold time-out period. This gesture is often called a tap.
GID_DOUBLESELECT	The user tapped two times on the screen in less time than the hold time-out. This gesture is often called a double-tap, and corresponds to a double-click of the left mouse key.
GID_DIRECTMANIPULATION	The user touched the screen and moved their finger. When direct manipulation is enabled, pan is disabled. Therefore, this gesture cannot be interpreted as a pan.

For more information about the gesture types, see Gesture Commands.

For more information about the GESTUREINFO structure, see GESTUREINFO.

Share via

Get Gesture Information (Compact 2013)

See Also

Concepts

Additional resources