struct CCL::ITouchHandler

Overview

Touch handler interface. More…

#include <imultitouch.h>

struct ITouchHandler: public CCL::IUnknown
{
    // methods

    virtual void CCL_API begin (const TouchEvent& event) = 0;
    virtual tbool CCL_API addTouch (const TouchEvent& event) = 0;
    virtual tbool CCL_API trigger (const TouchEvent& event) = 0;
    virtual void CCL_API finish (const TouchEvent& event, tbool canceled = false) = 0;

    virtual tbool CCL_API getRequiredGesture (
        int& gestureType,
        int& priority,
        int index
    ) = 0;

    virtual tbool CCL_API onGesture (const GestureEvent& event) = 0;
    virtual tbool CCL_API allowsCompetingGesture (int gestureType) = 0;
};

Inherited Members

public:
    // methods

    virtual tresult CCL_API queryInterface (UIDRef iid, void** ptr) = 0;
    virtual unsigned int CCL_API retain () = 0;
    virtual unsigned int CCL_API release () = 0;

Detailed Documentation

Touch handler interface.

Methods

virtual void CCL_API begin (const TouchEvent& event) = 0

Begin touch tracking.

virtual tbool CCL_API addTouch (const TouchEvent& event) = 0

Accept an additional touch or return false.

virtual tbool CCL_API trigger (const TouchEvent& event) = 0

Handle touch event.

virtual void CCL_API finish (const TouchEvent& event, tbool canceled = false) = 0

Finish touch tracking.

virtual tbool CCL_API getRequiredGesture (
    int& gestureType,
    int& priority,
    int index
) = 0

Get GestureEvent::EventType codes for required gestures; return false when no more gesture alternatives.

virtual tbool CCL_API onGesture (const GestureEvent& event) = 0

Handle gesture event; position is in window coordinates.

virtual tbool CCL_API allowsCompetingGesture (int gestureType) = 0

Query if handler wants to pass handling of the given gesture to another handler (e.g.

when touches are added / removed).