WM_TABLET_FLICK message

Sent when a user performs a pen flick. A window receives this message through its WindowProc function.

#define WM_TABLET_DEFBASE  0x02C0
#define WM_TABLET_FLICK    (WM_TABLET_DEFBASE + 11)     

Parameters

wParam

A FLICK_DATA Structure that contains information about the pen flick that occurred.

lParam

The FLICK_POINT Structure that specifies where the pen flick occurred.

Remarks

A pen flick is a unidirectional pen gesture that requires the user to contact the digitizer in a quick, straight flicking motion. A flick is characterized by high speed and a high degree of straightness. A flick is identified by its direction. Flicks can be made in eight directions corresponding to the cardinal and secondary compass directions.

When a pen flick occurs, Windows first notifies an application by sending a WM_TABLET_FLICK message, which a window receives through its WindowProc function. Return the FLICK_WM_HANDLED_MASK constant, described in Flicks Constants, to indicate that the application responded to the WM_TABLET_FLICK message. If the application does not return FLICK_WM_HANDLED_MASK, Windows performs the default action specified in the flicks control panel by sending a follow-up notification, such as WM_APPCOMMAND, WM_VSCROLL, or WM_KEYDOWN, depending on which action is associated with the pen flick.

Use caution when handling the WM_TABLET_FLICK message. WM_TABLET_FLICK is passed via the SendMessageTimeout function. If you call methods on a COM interface, that object must be within the same process. If not, COM throws an exception.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Tpcshrd.h

See also

flick_data structure

wm_tablet_flick message

flicks gestures

responding to pen flicks