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

See Also

Other Resources

Gesture Functions