Diffstat (limited to 'libopie2/opiepim/core/ocontactaccess.h') (more/less context) (ignore whitespace changes)
-rw-r--r-- | libopie2/opiepim/core/ocontactaccess.h | 49 |
1 files changed, 10 insertions, 39 deletions
diff --git a/libopie2/opiepim/core/ocontactaccess.h b/libopie2/opiepim/core/ocontactaccess.h index 54f7f07..adc66cf 100644 --- a/libopie2/opiepim/core/ocontactaccess.h +++ b/libopie2/opiepim/core/ocontactaccess.h | |||
@@ -8,24 +8,27 @@ | |||
8 | *This program is free software; you can redistribute it and/or | 8 | *This program is free software; you can redistribute it and/or |
9 | *modify it under the terms of the GNU Library General Public | 9 | *modify it under the terms of the GNU Library General Public |
10 | * License as published by the Free Software Foundation; | 10 | * License as published by the Free Software Foundation; |
11 | * either version 2 of the License, or (at your option) any later | 11 | * either version 2 of the License, or (at your option) any later |
12 | * version. | 12 | * version. |
13 | * ===================================================================== | 13 | * ===================================================================== |
14 | * ToDo: Define enum for query settings | 14 | * ToDo: Define enum for query settings |
15 | * ===================================================================== | 15 | * ===================================================================== |
16 | * Version: $Id$ | 16 | * Version: $Id$ |
17 | * ===================================================================== | 17 | * ===================================================================== |
18 | * History: | 18 | * History: |
19 | * $Log$ | 19 | * $Log$ |
20 | * Revision 1.2 2002/10/14 16:21:54 eilers | ||
21 | * Some minor interface updates | ||
22 | * | ||
20 | * Revision 1.1 2002/09/27 17:11:44 eilers | 23 | * Revision 1.1 2002/09/27 17:11:44 eilers |
21 | * Added API for accessing the Contact-Database ! It is compiling, but | 24 | * Added API for accessing the Contact-Database ! It is compiling, but |
22 | * please do not expect that anything is working ! | 25 | * please do not expect that anything is working ! |
23 | * I will debug that stuff in the next time .. | 26 | * I will debug that stuff in the next time .. |
24 | * Please read README_COMPILE for compiling ! | 27 | * Please read README_COMPILE for compiling ! |
25 | * | 28 | * |
26 | * ===================================================================== | 29 | * ===================================================================== |
27 | */ | 30 | */ |
28 | #ifndef _OCONTACTACCESS_H | 31 | #ifndef _OCONTACTACCESS_H |
29 | #define _OCONTACTACCESS_H | 32 | #define _OCONTACTACCESS_H |
30 | 33 | ||
31 | #include <qobject.h> | 34 | #include <qobject.h> |
@@ -38,85 +41,53 @@ | |||
38 | #include "ocontact.h" | 41 | #include "ocontact.h" |
39 | #include "ocontactaccessbackend.h" | 42 | #include "ocontactaccessbackend.h" |
40 | #include "opimaccesstemplate.h" | 43 | #include "opimaccesstemplate.h" |
41 | 44 | ||
42 | /** Class to access the contacts database. | 45 | /** Class to access the contacts database. |
43 | * This is just a frontend for the real database handling which is | 46 | * This is just a frontend for the real database handling which is |
44 | * done by the backend. | 47 | * done by the backend. |
45 | */ | 48 | */ |
46 | class OContactAccess: public QObject, public OPimAccessTemplate<OContact> | 49 | class OContactAccess: public QObject, public OPimAccessTemplate<OContact> |
47 | { | 50 | { |
48 | Q_OBJECT | 51 | Q_OBJECT |
49 | 52 | ||
50 | |||
51 | /* class Iterator{ | ||
52 | friend OContactAccess; | ||
53 | public: | ||
54 | Iterator(); | ||
55 | Iterator ( const Iterator& copy ); | ||
56 | |||
57 | bool operator== ( const Iterator& it ); | ||
58 | bool operator!= ( const Iterator& it ); | ||
59 | Iterator& operator= ( const Iterator& it ); | ||
60 | Iterator& operator++ (); // prefix | ||
61 | Iterator operator++ ( int ); // postfix | ||
62 | Iterator& operator-- (); // prefix | ||
63 | Iterator operator-- ( int ); // postfix | ||
64 | Contact operator*() const; | ||
65 | Contact operator->() const; | ||
66 | |||
67 | Iterator begin(); | ||
68 | Iterator end(); | ||
69 | |||
70 | uint count() const; | ||
71 | |||
72 | private: | ||
73 | QValueList<int> m_uids; | ||
74 | int m_cur_position; | ||
75 | bool m_end_reached; | ||
76 | OContactAccess *m_db; | ||
77 | |||
78 | }; | ||
79 | |||
80 | */ | ||
81 | |||
82 | public: | 53 | public: |
83 | /** Create Database with contacts (addressbook). | 54 | /** Create Database with contacts (addressbook). |
84 | * @param appname Name of application which wants access to the database | 55 | * @param appname Name of application which wants access to the database |
85 | * (i.e. "todolist") | 56 | * (i.e. "todolist") |
86 | * @param filename The name of the database file. If not set, the default one | 57 | * @param filename The name of the database file. If not set, the default one |
87 | * is used. | 58 | * is used. |
88 | * @param backend Pointer to an alternative Backend. If not set, we will use | 59 | * @param backend Pointer to an alternative Backend. If not set, we will use |
89 | * the default backend. | 60 | * the default backend. |
90 | * @param handlesync If <b>true</b> the database stores the current state | 61 | * @param handlesync If <b>true</b> the database stores the current state |
91 | * automatically if it receives the signals <i>flush()</i> and <i>reload()</i> | 62 | * automatically if it receives the signals <i>flush()</i> and <i>reload()</i> |
92 | * which are used before and after synchronisation. If the application wants | 63 | * which are used before and after synchronisation. If the application wants |
93 | * to react itself, it should be disabled by setting it to <b>false</b> | 64 | * to react itself, it should be disabled by setting it to <b>false</b> |
94 | * @see OContactBackend | 65 | * @see OContactAccessBackend |
95 | */ | 66 | */ |
96 | OContactAccess (const QString appname, const QString filename = 0l, | 67 | OContactAccess (const QString appname, const QString filename = 0l, |
97 | OContactAccessBackend* backend = 0l, bool handlesync = true); | 68 | OContactAccessBackend* backend = 0l, bool handlesync = true); |
98 | ~OContactAccess (); | 69 | ~OContactAccess (); |
99 | 70 | ||
100 | /** Constants for query. | 71 | /** Constants for query. |
101 | * Use this constants to set the query parameters. | 72 | * Use this constants to set the query parameters. |
102 | * Note: <i>query_IgnoreCase</i> just make sense with one of the other attributes ! | 73 | * Note: <i>query_IgnoreCase</i> just make sense with one of the other attributes ! |
103 | * @see queryByExample() | 74 | * @see queryByExample() |
104 | * - why not enum - zecke? | ||
105 | * -> Had some implementation problems .. Will use enum soon ! .. (se) | ||
106 | */ | 75 | */ |
107 | static const int query_WildCards = 0x0001; | 76 | enum QuerySettings { |
108 | static const int query_IgnoreCase = 0x0002; | 77 | WildCards = 0x0001, |
109 | static const int query_RegExp = 0x0004; | 78 | IgnoreCase = 0x0002, |
110 | static const int query_ExactMatch = 0x0008; | 79 | RegExp = 0x0004, |
80 | ExactMatch = 0x0008, | ||
81 | }; | ||
111 | 82 | ||
112 | /** Return all possible settings. | 83 | /** Return all possible settings. |
113 | * @return All settings provided by the current backend | 84 | * @return All settings provided by the current backend |
114 | * (i.e.: query_WildCards & query_IgnoreCase) | 85 | * (i.e.: query_WildCards & query_IgnoreCase) |
115 | */ | 86 | */ |
116 | const uint querySettings(); | 87 | const uint querySettings(); |
117 | 88 | ||
118 | /** Check whether settings are correct. | 89 | /** Check whether settings are correct. |
119 | * @return <i>true</i> if the given settings are correct and possible. | 90 | * @return <i>true</i> if the given settings are correct and possible. |
120 | */ | 91 | */ |
121 | bool hasQuerySettings ( int querySettings ) const; | 92 | bool hasQuerySettings ( int querySettings ) const; |
122 | 93 | ||