Share via


QueryGestures (Windows Embedded CE 6.0)

1/6/2010

This function returns the set of gestures that are enabled for a specific window or process. You can use this function so that your application can disable some or all gestures and then enable the gestures later.

Syntax

BOOL QueryGestures (
       HWND hwnd,
       UINT uScope,
       PULONGLONG pullFlags
);

Parameters

  • hwnd
    [in] Handle to the window to query.

    If uScope contains the TGF_SCOPE_PROCESS flag, the function ignores hwnd.

  • uScope
    [in] Bit value that specifies the scope of the query. The following flags are valid:

    • TGF_SCOPE_WINDOW
      Specifies a query for a particular window
    • TGF_SCOPE_PROCESS
      Specifies a query for a process
  • pullFlags
    [out] Pointer to the flags of the gestures that are enabled for the window or process. The following flags are supported for the core default gestures.

    Flag Description

    TGF_PAN

    Pan gesture

    TGF_SCROLL

    Flick gesture

    TGF_HOLD

    Hold gesture

    TGF_SELECT

    Tap gesture

    TGF_DOUBLESELECT

    Double tap gesture

    Additionally, you can specify custom registered gestures by bitwise comparing *pullFlags with the following macro: GID_TO_TGF(custom_gesture_id).

Return Value

Returns true if function succeeds; otherwise, false. To retrieve extended error information, call GetLastError.

Remarks

Querying with the process scope determines whether gestures are enabled for the process. It does not tell you whether gestures are enabled for a particular window of the process.

If a gesture is disabled at the process scope, the application does not receive gesture events for that gesture regardless of the gesture state of the individual application windows.

Requirements

Header pwinuser.h
Library TouchGesture.lib
sysgen SYSGEN_TOUCHGESTURE

See Also

Other Resources

Gesture Functions