--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/web_plat/stmgesturefw_api/inc/rt_gesturelistener.h Tue Feb 02 00:56:45 2010 +0200
@@ -0,0 +1,59 @@
+/*
+* 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_ */