contacts_plat/contacts_ui_extensions_api/inc/cntuiextensiongroup.h
changeset 37 fd64c38c277d
parent 27 de1630741fbe
--- a/contacts_plat/contacts_ui_extensions_api/inc/cntuiextensiongroup.h	Fri May 14 15:42:23 2010 +0300
+++ b/contacts_plat/contacts_ui_extensions_api/inc/cntuiextensiongroup.h	Thu May 27 12:45:19 2010 +0300
@@ -20,11 +20,21 @@
 
 #include <QObject>
 #include <cntviewparams.h>
+#include <cntextensiongroupcallback.h>
 
 class QPointF;
 
 /**
  * Handle to specific group provided by the group supplier
+ *
+ * Example usage for CntViewParameters callbacks:
+ *
+ * MyExtensionGroup::activated(CntViewParameters& callBack) const {
+ *     callBack.insert(EViewId, customView); <- when item is tapped, it opens the view specified here
+ *     callBack.insert(ECustomParam, myCustomParam); <- custom parameters can also be used if needed
+ * }
+ * 
+ * see cntviewparams.h for more information on view parameters
  */
 class CntUiExtensionGroup
 {
@@ -80,19 +90,21 @@
     virtual int serviceId() const = 0;
 
     /**
-     * Called when this item is activated (tapped) in the list.
+     * Called when this item is activated (tapped) in the list. The callback is handled 
+     * synchronously and therefore it is assumed that this should be used for
+     * opening a new view.
      *
      * @param CntViewParameters&, callback for view switching
      */   
-    virtual void activated(CntViewParameters& callBack) const = 0;
+    virtual void activated(CntViewParameters& callBack) = 0;
 
     /**
      * Called when this item is longpressed in the list.
      *
      * @param QPointF&, coordinates from where the longpress was initiated
-     * @param CntViewParameters&, callback for view switching
+     * @param CntExtensionGroupCallback*, callback interface for view switching, ownership NOT given
      */   
-    virtual void longPressed(const QPointF& coords, CntViewParameters &callBack) const = 0;
+    virtual void longPressed(const QPointF& coords, CntExtensionGroupCallback *interface) = 0;
 
     virtual void* GroupExtension(
             int /*aExtensionId*/ )