author | cgandhi <chandradeep.gandhi@sasken.com> |
Thu, 15 Apr 2010 15:35:36 +0530 | |
changeset 3 | 0446eb7b28aa |
permissions | -rw-r--r-- |
3
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
1 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
2 |
* Copyright (c) 2010 Sasken Communication Technologies Ltd. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
3 |
* All rights reserved. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
4 |
* This component and the accompanying materials are made available |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
5 |
* under the terms of the "Eclipse Public License v1.0" |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
6 |
* which accompanies this distribution, and is available |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
7 |
* at the URL "http://www.eclipse.org/legal/epl-v10.html" |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
8 |
* |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
9 |
* Initial Contributors: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
10 |
* Chandradeep Gandhi, Sasken Communication Technologies Ltd - Initial contribution |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
11 |
* |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
12 |
* Contributors: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
13 |
* Manasij Roy, Nalina Hariharan |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
14 |
* |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
15 |
* Description: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
16 |
* The SmfEvent class represents an event |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
17 |
* |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
18 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
19 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
20 |
#ifndef SMFCONTACTHETCHER_H |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
21 |
#define SMFCONTACTHETCHER_H |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
22 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
23 |
#include <QObject> |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
24 |
#include "smfglobal.h" |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
25 |
#include "smfprovider.h" |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
26 |
#include "smfcontact.h" |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
27 |
#include "smfplace.h" |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
28 |
class SmfProvider; //base-class for service provider |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
29 |
class SmfContact; //class for Contact in a social network |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
30 |
class SmfGroup; //class for a group in social network |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
31 |
typedef QList<SmfContact> SmfContactList; |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
32 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
33 |
//List of SmfGroup |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
34 |
typedef QList<SmfGroup> SmfGroupList; |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
35 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
36 |
* @ingroup smf_client_group |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
37 |
* Interface to search for contacts/connections from a service provider. This class |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
38 |
* provides basic functionality to allow applications to obtain list of |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
39 |
* contacts or friends in a social networking service. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
40 |
* Note that to get the base provider info like service name, icon, description etc |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
41 |
* use getProvider(). |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
42 |
* See also: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
43 |
* SmfProvider::serviceName(), SmfProvider::serviceIcon(), SmfProvider::description() |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
44 |
* |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
45 |
* All of the functionality described here should be implemented by a service |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
46 |
* specific plug-in object. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
47 |
* Interface name:- org.symbian.smf.client.contact.fetcher |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
48 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
49 |
class SMFCLIENT_EXPORT SmfContactFetcher : public QObject |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
50 |
{ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
51 |
Q_OBJECT |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
52 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
53 |
public: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
54 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
55 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
56 |
* Constructs the SmfContactFetcher. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
57 |
* @param parent base provider info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
58 |
* @param contact Used for searching friends of the given contact |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
59 |
* Seeing as this is a plug-in implementation, these will realistically |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
60 |
* be generated by SMF factory of some kind |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
61 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
62 |
SmfContactFetcher(SmfProvider* baseProvider); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
63 |
SmfContactFetcher(SmfProvider* baseProvider, SmfContact* contact); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
64 |
~SmfContactFetcher(); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
65 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
66 |
public: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
67 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
68 |
* Get the friend listing asynchronously. The friendsListAvailable() signal |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
69 |
* is emitted with SmfContactList once data is arrived. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
70 |
* When the list is big user can specify the page number and per page item data. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
71 |
* If not supplied by the user default values are used. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
72 |
* @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
73 |
* @param perPage Item per page, default is SMF_ITEMS_PER_PAGE |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
74 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
75 |
bool friends(int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
76 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
77 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
78 |
* Get the list of followers asynchronously. The followersListAvailable() signal |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
79 |
* is emitted with SmfContactList once data is arrived. Please note that some |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
80 |
* service may not support followers/fans - FALSE is returned if not supported. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
81 |
* When the list is big user can specify the page number and per page item data. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
82 |
* If not supplied by the user default values are used. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
83 |
* @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
84 |
* @param perPage Item per page, default is SMF_ITEMS_PER_PAGE |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
85 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
86 |
bool followers(int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE); // list of contact objects |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
87 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
88 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
89 |
* Searches for a contact The searchContactFinished() signal |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
90 |
* is emitted with SmfContactList once data is arrived. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
91 |
* When the list is big user can specify the page number and per page item data. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
92 |
* If not supplied by the user default values are used. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
93 |
* @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
94 |
* @param perPage Item per page, default is SMF_ITEMS_PER_PAGE |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
95 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
96 |
void search(SmfContact* contact,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // list of contact objects |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
97 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
98 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
99 |
* Searches for a contacts (friends) who are near the user. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
100 |
* Signal searchNearFinished() is emitted with SmfContactList once data is arrived. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
101 |
* Proximity defines accuracy level |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
102 |
* When the list is big user can specify the page number and per page item data. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
103 |
* If not supplied by the user default values are used. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
104 |
* @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
105 |
* @param perPage Item per page, default is SMF_ITEMS_PER_PAGE |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
106 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
107 |
bool searchNear(SmfPlace* location,SmfLocationSearchBoundary proximity,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
108 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
109 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
110 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
111 |
* Get the list of groups. The groupListAvailable() signal |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
112 |
* is emitted with SmfGroupList once data is arrived. False might be returned |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
113 |
* if this service doesn't support any mode of grouping (very rare). |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
114 |
* When the list is big user can specify the page number and per page item data. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
115 |
* If not supplied by the user default values are used. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
116 |
* @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
117 |
* @param perPage Item per page, default is SMF_ITEMS_PER_PAGE |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
118 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
119 |
bool groups(int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // list of group objects |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
120 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
121 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
122 |
* Searches for Smf Contacts in an Smf group. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
123 |
* When the list is big user can specify the page number and per page item data. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
124 |
* If not supplied by the user default values are used. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
125 |
* @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
126 |
* @param perPage Item per page, default is SMF_ITEMS_PER_PAGE |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
127 |
* @param group The group to be searcged in |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
128 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
129 |
bool searchInGroup(SmfGroup group,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // list of contact objects |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
130 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
131 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
132 |
//APIs to get/set base provider info (SmfProvider) |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
133 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
134 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
135 |
* Gets the base provider info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
136 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
137 |
SmfProvider* getProvider() ; |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
138 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
139 |
public slots: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
140 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
141 |
signals: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
142 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
143 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
144 |
* This signal is emitted when a request to get friends is completed. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
145 |
* Note if number of friends is large, then it can download the list page by page. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
146 |
* In that case this signal is emitted multiple times. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
147 |
* @param list list of friends |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
148 |
* @param error error string |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
149 |
* @param resultPage Page number info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
150 |
* @see friends() |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
151 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
152 |
void friendsListAvailable(SmfContactList* list, QString error, SmfResultPage resultPage); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
153 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
154 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
155 |
* This signal is emitted when a request to get followers is completed |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
156 |
* Note if number of followers is large, then it can download the list page by page |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
157 |
* In that case this signal is emitted multiple times. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
158 |
* @param list list of followers |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
159 |
* @param error error string |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
160 |
* @param resultPage Page number info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
161 |
* @see followers() |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
162 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
163 |
void followersListAvailable(SmfContactList* list, QString error, SmfResultPage resultPage); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
164 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
165 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
166 |
* This signal is emitted when a request to get groups is completed |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
167 |
* Note if number of groups is large, then it can download the list page by page |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
168 |
* In that case this signal is emitted multiple times. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
169 |
* @param list list of groups |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
170 |
* @param error error string |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
171 |
* @param resultPage Page number info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
172 |
* @see groups() |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
173 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
174 |
void groupListAvailable(SmfGroupList* list, QString error, SmfResultPage resultPage); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
175 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
176 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
177 |
* Emitted when search for a contact is finished. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
178 |
* Note if number of contacts in the search is large, then it can download the list page by page |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
179 |
* In that case this signal is emitted multiple times. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
180 |
* @param list List of filtered contacts |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
181 |
* @param resultPage Page number info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
182 |
* @see search() |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
183 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
184 |
void searchContactFinished(SmfContactList* list,QString error, SmfResultPage resultPage); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
185 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
186 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
187 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
188 |
* Emitted when search for contacts who are near a geographic location, is finished. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
189 |
* Note if number of contacts in the search is large, then it can download the list page by page |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
190 |
* In that case this signal is emitted multiple times. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
191 |
* @param list List of filtered contacts |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
192 |
* @param resultPage Page number info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
193 |
* @see search() |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
194 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
195 |
void searchNearFinished(SmfContactList* list,QString error, SmfResultPage resultPage); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
196 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
197 |
/** |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
198 |
* Emitted when search for a contact in a group is finished |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
199 |
* Note if number of contacts in the search is large, then it can download the list page by page |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
200 |
* In that case this signal is emitted multiple times. |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
201 |
* @param list list of filtered contacts |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
202 |
* @param resultPage Page number info |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
203 |
* @see searchInGroup() |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
204 |
*/ |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
205 |
void searchInGroupFinished(SmfContactList* list,QString error, SmfResultPage resultPage); |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
206 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
207 |
private: |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
208 |
SmfProvider* m_baseProvider; |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
209 |
}; |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
210 |
|
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
211 |
SMF_SERVICE_NAME(SmfContactFetcher, "org.symbian.smf.client.contact.fetcher\0.2") |
0446eb7b28aa
Updating the sample plugin and other related changes for clients and plugins
cgandhi <chandradeep.gandhi@sasken.com>
parents:
diff
changeset
|
212 |
#endif // SMFCONTACTHETCHER_H |