Share via


TKGetAnimateMessageInfo

4/8/2010

This function retrieves the movement information for any animate messages sent by Windows Auto Gesture. This feature enable the content in a window to scroll automatically in response to flick and pan gestures.

To automatically handle gesture scrolling, WS_VSCROLL or WS_HSCROLL (or both) styles must be included in the target window with scroll ranges that are set correctly.

After an application calls TKSetWindowAutoGesture and specifies the WAGIF_OWNERANIMATE flag, messages are sent to the window procedure when the content is animated. The application should call this function for each animation message to retrieve the correct values for that message.

Syntax

BOOL TKGetAnimateMessageInfo(
    HWND hWnd, 
    WPARAM wParam, 
    LPARAM lParam, 
    LPANIMATEMESSAGEINFO pAnimateMessageInfo
);

Parameters

  • hWnd
    [in] The handle of the target window.
  • wParam
    [in] The wParam of the animation message.
  • lParam
    [in] The lParam of the animation message.
  • pAnimateMessageInfo
    [out] A pointer to the ANIMATEMESSAGEINFO struct to be populated with the movement information.

Return Value

Returns TRUE if successful, or FALSE in the event of an error. To get extended error information, call GetLastError.

Remarks

You must call TKSetWindowAutoGesture and set the WAGIF_OWNERANIMATE flag for the window before the target window will receive any animation messages.

Requirements

Header WindowAutoGesture.h

See Also

Other Resources

Using Gestures in Windows Mobile 6.5