-rw-r--r-- | kabc/addressee.h | 2 |
1 files changed, 2 insertions, 0 deletions
diff --git a/kabc/addressee.h b/kabc/addressee.h index f098371..0805458 100644 --- a/kabc/addressee.h +++ b/kabc/addressee.h | |||
@@ -1,300 +1,302 @@ | |||
1 | /*** Warning! This file has been generated by the script makeaddressee ***/ | 1 | /*** Warning! This file has been generated by the script makeaddressee ***/ |
2 | /* | 2 | /* |
3 | This file is part of libkabc. | 3 | This file is part of libkabc. |
4 | Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> | 4 | Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> |
5 | 5 | ||
6 | This library is free software; you can redistribute it and/or | 6 | This library is free software; you can redistribute it and/or |
7 | modify it under the terms of the GNU Library General Public | 7 | modify it under the terms of the GNU Library General Public |
8 | License as published by the Free Software Foundation; either | 8 | License as published by the Free Software Foundation; either |
9 | version 2 of the License, or (at your option) any later version. | 9 | version 2 of the License, or (at your option) any later version. |
10 | 10 | ||
11 | This library is distributed in the hope that it will be useful, | 11 | This library is distributed in the hope that it will be useful, |
12 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | 13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
14 | Library General Public License for more details. | 14 | Library General Public License for more details. |
15 | 15 | ||
16 | You should have received a copy of the GNU Library General Public License | 16 | You should have received a copy of the GNU Library General Public License |
17 | along with this library; see the file COPYING.LIB. If not, write to | 17 | along with this library; see the file COPYING.LIB. If not, write to |
18 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | 18 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, |
19 | Boston, MA 02111-1307, USA. | 19 | Boston, MA 02111-1307, USA. |
20 | */ | 20 | */ |
21 | 21 | ||
22 | /* | 22 | /* |
23 | Enhanced Version of the file for platform independent KDE tools. | 23 | Enhanced Version of the file for platform independent KDE tools. |
24 | Copyright (c) 2004 Ulf Schenk | 24 | Copyright (c) 2004 Ulf Schenk |
25 | 25 | ||
26 | $Id$ | 26 | $Id$ |
27 | */ | 27 | */ |
28 | 28 | ||
29 | #ifndef KABC_ADDRESSEE_H | 29 | #ifndef KABC_ADDRESSEE_H |
30 | #define KABC_ADDRESSEE_H | 30 | #define KABC_ADDRESSEE_H |
31 | 31 | ||
32 | #include <qdatetime.h> | 32 | #include <qdatetime.h> |
33 | #include <qstring.h> | 33 | #include <qstring.h> |
34 | #include <qstringlist.h> | 34 | #include <qstringlist.h> |
35 | #include <qvaluelist.h> | 35 | #include <qvaluelist.h> |
36 | 36 | ||
37 | #include <ksharedptr.h> | 37 | #include <ksharedptr.h> |
38 | #include <kurl.h> | 38 | #include <kurl.h> |
39 | 39 | ||
40 | #include "address.h" | 40 | #include "address.h" |
41 | #include "agent.h" | 41 | #include "agent.h" |
42 | #include "geo.h" | 42 | #include "geo.h" |
43 | #include "key.h" | 43 | #include "key.h" |
44 | #include "phonenumber.h" | 44 | #include "phonenumber.h" |
45 | #include "picture.h" | 45 | #include "picture.h" |
46 | #include "secrecy.h" | 46 | #include "secrecy.h" |
47 | #include "sound.h" | 47 | #include "sound.h" |
48 | #include "timezone.h" | 48 | #include "timezone.h" |
49 | 49 | ||
50 | namespace KABC { | 50 | namespace KABC { |
51 | 51 | ||
52 | class Resource; | 52 | class Resource; |
53 | 53 | ||
54 | /** | 54 | /** |
55 | @short address book entry | 55 | @short address book entry |
56 | 56 | ||
57 | This class represents an entry in the address book. | 57 | This class represents an entry in the address book. |
58 | 58 | ||
59 | The data of this class is implicitly shared. You can pass this class by value. | 59 | The data of this class is implicitly shared. You can pass this class by value. |
60 | 60 | ||
61 | If you need the name of a field for presenting it to the user you should use | 61 | If you need the name of a field for presenting it to the user you should use |
62 | the functions ending in Label(). They return a translated string which can be | 62 | the functions ending in Label(). They return a translated string which can be |
63 | used as label for the corresponding field. | 63 | used as label for the corresponding field. |
64 | 64 | ||
65 | About the name fields: | 65 | About the name fields: |
66 | 66 | ||
67 | givenName() is the first name and familyName() the last name. In some | 67 | givenName() is the first name and familyName() the last name. In some |
68 | countries the family name comes first, that's the reason for the | 68 | countries the family name comes first, that's the reason for the |
69 | naming. formattedName() is the full name with the correct formatting. | 69 | naming. formattedName() is the full name with the correct formatting. |
70 | It is used as an override, when the correct formatting can't be generated | 70 | It is used as an override, when the correct formatting can't be generated |
71 | from the other name fields automatically. | 71 | from the other name fields automatically. |
72 | 72 | ||
73 | realName() returns a fully formatted name(). It uses formattedName, if set, | 73 | realName() returns a fully formatted name(). It uses formattedName, if set, |
74 | otherwise it constucts the name from the name fields. As fallback, if | 74 | otherwise it constucts the name from the name fields. As fallback, if |
75 | nothing else is set it uses name(). | 75 | nothing else is set it uses name(). |
76 | 76 | ||
77 | name() is the NAME type of RFC2426. It can be used as internal name for the | 77 | name() is the NAME type of RFC2426. It can be used as internal name for the |
78 | data enty, but shouldn't be used for displaying the data to the user. | 78 | data enty, but shouldn't be used for displaying the data to the user. |
79 | */ | 79 | */ |
80 | class Addressee | 80 | class Addressee |
81 | { | 81 | { |
82 | friend QDataStream &operator<<( QDataStream &, const Addressee & ); | 82 | friend QDataStream &operator<<( QDataStream &, const Addressee & ); |
83 | friend QDataStream &operator>>( QDataStream &, Addressee & ); | 83 | friend QDataStream &operator>>( QDataStream &, Addressee & ); |
84 | 84 | ||
85 | public: | 85 | public: |
86 | typedef QValueList<Addressee> List; | 86 | typedef QValueList<Addressee> List; |
87 | 87 | ||
88 | /** | 88 | /** |
89 | Construct an empty address book entry. | 89 | Construct an empty address book entry. |
90 | */ | 90 | */ |
91 | Addressee(); | 91 | Addressee(); |
92 | ~Addressee(); | 92 | ~Addressee(); |
93 | 93 | ||
94 | Addressee( const Addressee & ); | 94 | Addressee( const Addressee & ); |
95 | Addressee &operator=( const Addressee & ); | 95 | Addressee &operator=( const Addressee & ); |
96 | 96 | ||
97 | bool operator==( const Addressee & ) const; | 97 | bool operator==( const Addressee & ) const; |
98 | bool operator!=( const Addressee & ) const; | 98 | bool operator!=( const Addressee & ) const; |
99 | // sync stuff | 99 | // sync stuff |
100 | void setTempSyncStat(int id); | 100 | void setTempSyncStat(int id); |
101 | int tempSyncStat() const; | 101 | int tempSyncStat() const; |
102 | void setIDStr( const QString & ); | 102 | void setIDStr( const QString & ); |
103 | QString IDStr() const; | 103 | QString IDStr() const; |
104 | void setID( const QString &, const QString & ); | 104 | void setID( const QString &, const QString & ); |
105 | QString getID( const QString & ); | 105 | QString getID( const QString & ); |
106 | void setCsum( const QString &, const QString & ); | 106 | void setCsum( const QString &, const QString & ); |
107 | QString getCsum( const QString & ); | 107 | QString getCsum( const QString & ); |
108 | void removeID(const QString &); | 108 | void removeID(const QString &); |
109 | void computeCsum(const QString &dev); | ||
110 | ulong getCsum4List( const QStringList & attList); | ||
109 | /** | 111 | /** |
110 | Return, if the address book entry is empty. | 112 | Return, if the address book entry is empty. |
111 | */ | 113 | */ |
112 | bool isEmpty() const; | 114 | bool isEmpty() const; |
113 | 115 | ||
114 | /** | 116 | /** |
115 | Set unique identifier. | 117 | Set unique identifier. |
116 | */ | 118 | */ |
117 | void setUid( const QString &uid ); | 119 | void setUid( const QString &uid ); |
118 | /** | 120 | /** |
119 | Return unique identifier. | 121 | Return unique identifier. |
120 | */ | 122 | */ |
121 | QString uid() const; | 123 | QString uid() const; |
122 | /** | 124 | /** |
123 | Return translated label for uid field. | 125 | Return translated label for uid field. |
124 | */ | 126 | */ |
125 | static QString uidLabel(); | 127 | static QString uidLabel(); |
126 | 128 | ||
127 | /** | 129 | /** |
128 | Set name. | 130 | Set name. |
129 | */ | 131 | */ |
130 | void setName( const QString &name ); | 132 | void setName( const QString &name ); |
131 | /** | 133 | /** |
132 | Return name. | 134 | Return name. |
133 | */ | 135 | */ |
134 | QString name() const; | 136 | QString name() const; |
135 | /** | 137 | /** |
136 | Return translated label for name field. | 138 | Return translated label for name field. |
137 | */ | 139 | */ |
138 | static QString nameLabel(); | 140 | static QString nameLabel(); |
139 | 141 | ||
140 | /** | 142 | /** |
141 | Set formatted name. | 143 | Set formatted name. |
142 | */ | 144 | */ |
143 | void setFormattedName( const QString &formattedName ); | 145 | void setFormattedName( const QString &formattedName ); |
144 | /** | 146 | /** |
145 | Return formatted name. | 147 | Return formatted name. |
146 | */ | 148 | */ |
147 | QString formattedName() const; | 149 | QString formattedName() const; |
148 | /** | 150 | /** |
149 | Return translated label for formattedName field. | 151 | Return translated label for formattedName field. |
150 | */ | 152 | */ |
151 | static QString formattedNameLabel(); | 153 | static QString formattedNameLabel(); |
152 | 154 | ||
153 | /** | 155 | /** |
154 | Set family name. | 156 | Set family name. |
155 | */ | 157 | */ |
156 | void setFamilyName( const QString &familyName ); | 158 | void setFamilyName( const QString &familyName ); |
157 | /** | 159 | /** |
158 | Return family name. | 160 | Return family name. |
159 | */ | 161 | */ |
160 | QString familyName() const; | 162 | QString familyName() const; |
161 | /** | 163 | /** |
162 | Return translated label for familyName field. | 164 | Return translated label for familyName field. |
163 | */ | 165 | */ |
164 | static QString familyNameLabel(); | 166 | static QString familyNameLabel(); |
165 | 167 | ||
166 | /** | 168 | /** |
167 | Set given name. | 169 | Set given name. |
168 | */ | 170 | */ |
169 | void setGivenName( const QString &givenName ); | 171 | void setGivenName( const QString &givenName ); |
170 | /** | 172 | /** |
171 | Return given name. | 173 | Return given name. |
172 | */ | 174 | */ |
173 | QString givenName() const; | 175 | QString givenName() const; |
174 | /** | 176 | /** |
175 | Return translated label for givenName field. | 177 | Return translated label for givenName field. |
176 | */ | 178 | */ |
177 | static QString givenNameLabel(); | 179 | static QString givenNameLabel(); |
178 | 180 | ||
179 | /** | 181 | /** |
180 | Set additional names. | 182 | Set additional names. |
181 | */ | 183 | */ |
182 | void setAdditionalName( const QString &additionalName ); | 184 | void setAdditionalName( const QString &additionalName ); |
183 | /** | 185 | /** |
184 | Return additional names. | 186 | Return additional names. |
185 | */ | 187 | */ |
186 | QString additionalName() const; | 188 | QString additionalName() const; |
187 | /** | 189 | /** |
188 | Return translated label for additionalName field. | 190 | Return translated label for additionalName field. |
189 | */ | 191 | */ |
190 | static QString additionalNameLabel(); | 192 | static QString additionalNameLabel(); |
191 | 193 | ||
192 | /** | 194 | /** |
193 | Set honorific prefixes. | 195 | Set honorific prefixes. |
194 | */ | 196 | */ |
195 | void setPrefix( const QString &prefix ); | 197 | void setPrefix( const QString &prefix ); |
196 | /** | 198 | /** |
197 | Return honorific prefixes. | 199 | Return honorific prefixes. |
198 | */ | 200 | */ |
199 | QString prefix() const; | 201 | QString prefix() const; |
200 | /** | 202 | /** |
201 | Return translated label for prefix field. | 203 | Return translated label for prefix field. |
202 | */ | 204 | */ |
203 | static QString prefixLabel(); | 205 | static QString prefixLabel(); |
204 | 206 | ||
205 | /** | 207 | /** |
206 | Set honorific suffixes. | 208 | Set honorific suffixes. |
207 | */ | 209 | */ |
208 | void setSuffix( const QString &suffix ); | 210 | void setSuffix( const QString &suffix ); |
209 | /** | 211 | /** |
210 | Return honorific suffixes. | 212 | Return honorific suffixes. |
211 | */ | 213 | */ |
212 | QString suffix() const; | 214 | QString suffix() const; |
213 | /** | 215 | /** |
214 | Return translated label for suffix field. | 216 | Return translated label for suffix field. |
215 | */ | 217 | */ |
216 | static QString suffixLabel(); | 218 | static QString suffixLabel(); |
217 | 219 | ||
218 | /** | 220 | /** |
219 | Set nick name. | 221 | Set nick name. |
220 | */ | 222 | */ |
221 | void setNickName( const QString &nickName ); | 223 | void setNickName( const QString &nickName ); |
222 | /** | 224 | /** |
223 | Return nick name. | 225 | Return nick name. |
224 | */ | 226 | */ |
225 | QString nickName() const; | 227 | QString nickName() const; |
226 | /** | 228 | /** |
227 | Return translated label for nickName field. | 229 | Return translated label for nickName field. |
228 | */ | 230 | */ |
229 | static QString nickNameLabel(); | 231 | static QString nickNameLabel(); |
230 | 232 | ||
231 | /** | 233 | /** |
232 | Set birthday. | 234 | Set birthday. |
233 | */ | 235 | */ |
234 | void setBirthday( const QDateTime &birthday ); | 236 | void setBirthday( const QDateTime &birthday ); |
235 | /** | 237 | /** |
236 | Return birthday. | 238 | Return birthday. |
237 | */ | 239 | */ |
238 | QDateTime birthday() const; | 240 | QDateTime birthday() const; |
239 | /** | 241 | /** |
240 | Return translated label for birthday field. | 242 | Return translated label for birthday field. |
241 | */ | 243 | */ |
242 | static QString birthdayLabel(); | 244 | static QString birthdayLabel(); |
243 | 245 | ||
244 | /** | 246 | /** |
245 | Return translated label for homeAddressStreet field. | 247 | Return translated label for homeAddressStreet field. |
246 | */ | 248 | */ |
247 | static QString homeAddressStreetLabel(); | 249 | static QString homeAddressStreetLabel(); |
248 | 250 | ||
249 | /** | 251 | /** |
250 | Return translated label for homeAddressLocality field. | 252 | Return translated label for homeAddressLocality field. |
251 | */ | 253 | */ |
252 | static QString homeAddressLocalityLabel(); | 254 | static QString homeAddressLocalityLabel(); |
253 | 255 | ||
254 | /** | 256 | /** |
255 | Return translated label for homeAddressRegion field. | 257 | Return translated label for homeAddressRegion field. |
256 | */ | 258 | */ |
257 | static QString homeAddressRegionLabel(); | 259 | static QString homeAddressRegionLabel(); |
258 | 260 | ||
259 | /** | 261 | /** |
260 | Return translated label for homeAddressPostalCode field. | 262 | Return translated label for homeAddressPostalCode field. |
261 | */ | 263 | */ |
262 | static QString homeAddressPostalCodeLabel(); | 264 | static QString homeAddressPostalCodeLabel(); |
263 | 265 | ||
264 | /** | 266 | /** |
265 | Return translated label for homeAddressCountry field. | 267 | Return translated label for homeAddressCountry field. |
266 | */ | 268 | */ |
267 | static QString homeAddressCountryLabel(); | 269 | static QString homeAddressCountryLabel(); |
268 | 270 | ||
269 | /** | 271 | /** |
270 | Return translated label for homeAddressLabel field. | 272 | Return translated label for homeAddressLabel field. |
271 | */ | 273 | */ |
272 | static QString homeAddressLabelLabel(); | 274 | static QString homeAddressLabelLabel(); |
273 | 275 | ||
274 | /** | 276 | /** |
275 | Return translated label for businessAddressStreet field. | 277 | Return translated label for businessAddressStreet field. |
276 | */ | 278 | */ |
277 | static QString businessAddressStreetLabel(); | 279 | static QString businessAddressStreetLabel(); |
278 | 280 | ||
279 | /** | 281 | /** |
280 | Return translated label for businessAddressLocality field. | 282 | Return translated label for businessAddressLocality field. |
281 | */ | 283 | */ |
282 | static QString businessAddressLocalityLabel(); | 284 | static QString businessAddressLocalityLabel(); |
283 | 285 | ||
284 | /** | 286 | /** |
285 | Return translated label for businessAddressRegion field. | 287 | Return translated label for businessAddressRegion field. |
286 | */ | 288 | */ |
287 | static QString businessAddressRegionLabel(); | 289 | static QString businessAddressRegionLabel(); |
288 | 290 | ||
289 | /** | 291 | /** |
290 | Return translated label for businessAddressPostalCode field. | 292 | Return translated label for businessAddressPostalCode field. |
291 | */ | 293 | */ |
292 | static QString businessAddressPostalCodeLabel(); | 294 | static QString businessAddressPostalCodeLabel(); |
293 | 295 | ||
294 | /** | 296 | /** |
295 | Return translated label for businessAddressCountry field. | 297 | Return translated label for businessAddressCountry field. |
296 | */ | 298 | */ |
297 | static QString businessAddressCountryLabel(); | 299 | static QString businessAddressCountryLabel(); |
298 | 300 | ||
299 | /** | 301 | /** |
300 | Return translated label for businessAddressLabel field. | 302 | Return translated label for businessAddressLabel field. |