Share via


GESTUREINFO (Compact 2013)

3/28/2014

The GESTUREINFO structure contains information about a gesture event. You can use this structure to post an event by using the Gesture function, or you can populate this structure by using the GetGestureInfo function to handle a WM_GESTURE window message.

Syntax

typedef struct tagGESTUREINFO {
    UINT cbSize;
    DWORD dwFlags;
    DWORD dwID;
        HWND hwndTarget;
    POINTS ptsLocation;
    DWORD dwInstanceID;
    DWORD dwSequenceID;
    ULONGLONG ullArguments;
    UINT cbExtraArguments;
} GESTUREINFO, *PGESTUREINFO;

Parameters

  • cbSize
    Contains the size of the structure. You must initialize this to sizeof(GESTUREINFO) before you call GetGestureInfo.
  • dwFlags
    Contains the gesture flags. The following values are valid:

    Flag

    Description

    • GF_BEGIN

    Indicates the start of a gesture.

    • GF_INERTIA

    Indicates that a flick gesture has occurred at the end of a pan gesture.

    • GF_END

    Indicates the end of a gesture.

    • GF_SYMMETRIC

    Indicates a symmetric gesture (two contact points with identical actions).

    • GF_SYNC

    Indicates a gesture sent directly to the window procedure.

    • If you set both the GF_BEGIN and GF_END flags, then the gesture is noncontinuous and the system sends only a single gesture message.
    • If a pan gesture turns into a flick gesture, the last pan gesture message has both GF_INERTIA and GF_END flags set.

    Important

    These flags are different from the GID_BEGIN and GID_END window messages. GID_BEGIN and GID_END indicate the beginning and end of a gesture group, which can consist of one or more gestures. Each individual gesture has GF_BEGIN and GF_END flags that indicate the start and end of that individual gesture.

  • dwID
    Contains the ID of a gesture command. For a list of predefined gestures, see Gesture Commands.
  • hwndTarget
    Contains the handle to the target window that receives the gestures.
  • ptsLocation
    Points to a POINTS structure that contains the screen coordinates associated with the gesture.
  • dwInstanceID
    Reserved.
  • dwSequenceID
    Contains the time stamp of the gesture event. You can use this time stamp to handle the delay between a pan gesture and a corresponding flick gesture.
  • ullArguments
    Contains additional information associated with the command. The argument values in this field depend on the gesture command. For pans, this field contains the pan movement deltas. For flicks, this field contains the direction, angle and velocity of the flick.
  • cbExtraArguments
    Contains the size, in bytes, of the extra information about the gesture. If this value is greater than 0 (zero), you can call GetGestureExtraArguments to retrieve the additional information.

Requirements

Header

touchgesture.h

sysgen

SYSGEN_TOUCHGESTURE

See Also

Reference

Gesture Structures