/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: Gesture helper implementation
*
*/
#ifndef RT_GESTURELISTENER_H_
#define RT_GESTURELISTENER_H_
#include <rt_gestureif.h>
namespace stmGesture
{
/*!
* The gesture listener interface. This interface needs to be implemented by the
* listener of the standard gestures implemented in the gesture framework.
*/
class MGestureListener
{
public:
/*!
* The method that will be called by the gesture framework
* to inform about a gesture being recognised.
* \param theGesture: contains the recognised gesture.
* The MGestureIf contains generic part and gesture specific part
* so the listener needs to know how to handle specific gestures.
*/
virtual void gestureEnter(MGestureIf& theGesture) = 0 ;
/*!
* The method to inform the listener that the gesture has ended.
* This happens if another gesture is recognised or e.g. the Release UI
* event is handled.
* \note Some gestures produce only gestureEnter() callback and no gestureExit().
*/
virtual void gestureExit(TGestureUid gestureUid) = 0 ;
/*!
* The listener needs to provide the target control (CCoeControl*) to the
* standard gestures. Since the gesture framework processes all events in the
* application, the gesture recognisers check whether the events are targeted
* to the listener owning control.
* Not all gesture recognisers need to perform this check.
* \return the owning CCoeControl of the gesture listener.
*/
virtual CCoeControl* getOwner() = 0 ;
};
}
#endif /* RT_GESTURELISTENER_H_ */