summaryrefslogtreecommitdiffabout
path: root/kabc/addressee.h
authorzautrix <zautrix>2004-09-19 11:32:40 (UTC)
committer zautrix <zautrix>2004-09-19 11:32:40 (UTC)
commiteea0ff04703dffdbe8b67a0dc9f592597d7450c1 (patch) (unidiff)
tree874549d9c1c6239304fe1540d1b56269652954c0 /kabc/addressee.h
parent953277a85e6ec5630ab0d64b4d68815e4e4f9906 (diff)
downloadkdepimpi-eea0ff04703dffdbe8b67a0dc9f592597d7450c1.zip
kdepimpi-eea0ff04703dffdbe8b67a0dc9f592597d7450c1.tar.gz
kdepimpi-eea0ff04703dffdbe8b67a0dc9f592597d7450c1.tar.bz2
more AB sync
Diffstat (limited to 'kabc/addressee.h') (more/less context) (ignore whitespace changes)
-rw-r--r--kabc/addressee.h4
1 files changed, 3 insertions, 1 deletions
diff --git a/kabc/addressee.h b/kabc/addressee.h
index bfb0840..59fcbd8 100644
--- a/kabc/addressee.h
+++ b/kabc/addressee.h
@@ -1,499 +1,501 @@
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/*
23Enhanced Version of the file for platform independent KDE tools. 23Enhanced Version of the file for platform independent KDE tools.
24Copyright (c) 2004 Ulf Schenk 24Copyright (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
50namespace KABC { 50namespace KABC {
51 51
52class Resource; 52class 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 */
80class Addressee 80class 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); 109 void computeCsum(const QString &dev);
110 ulong getCsum4List( const QStringList & attList); 110 ulong getCsum4List( const QStringList & attList);
111 /** 111 /**
112 Return, if the address book entry is empty. 112 Return, if the address book entry is empty.
113 */ 113 */
114 bool isEmpty() const; 114 bool isEmpty() const;
115 115 void setExternalUID( const QString &id );
116 QString externalUID() const;
117 void mergeContact( Addressee ad );
116 /** 118 /**
117 Set unique identifier. 119 Set unique identifier.
118 */ 120 */
119 void setUid( const QString &uid ); 121 void setUid( const QString &uid );
120 /** 122 /**
121 Return unique identifier. 123 Return unique identifier.
122 */ 124 */
123 QString uid() const; 125 QString uid() const;
124 /** 126 /**
125 Return translated label for uid field. 127 Return translated label for uid field.
126 */ 128 */
127 static QString uidLabel(); 129 static QString uidLabel();
128 130
129 /** 131 /**
130 Set name. 132 Set name.
131 */ 133 */
132 void setName( const QString &name ); 134 void setName( const QString &name );
133 /** 135 /**
134 Return name. 136 Return name.
135 */ 137 */
136 QString name() const; 138 QString name() const;
137 /** 139 /**
138 Return translated label for name field. 140 Return translated label for name field.
139 */ 141 */
140 static QString nameLabel(); 142 static QString nameLabel();
141 143
142 /** 144 /**
143 Set formatted name. 145 Set formatted name.
144 */ 146 */
145 void setFormattedName( const QString &formattedName ); 147 void setFormattedName( const QString &formattedName );
146 /** 148 /**
147 Return formatted name. 149 Return formatted name.
148 */ 150 */
149 QString formattedName() const; 151 QString formattedName() const;
150 /** 152 /**
151 Return translated label for formattedName field. 153 Return translated label for formattedName field.
152 */ 154 */
153 static QString formattedNameLabel(); 155 static QString formattedNameLabel();
154 156
155 /** 157 /**
156 Set family name. 158 Set family name.
157 */ 159 */
158 void setFamilyName( const QString &familyName ); 160 void setFamilyName( const QString &familyName );
159 /** 161 /**
160 Return family name. 162 Return family name.
161 */ 163 */
162 QString familyName() const; 164 QString familyName() const;
163 /** 165 /**
164 Return translated label for familyName field. 166 Return translated label for familyName field.
165 */ 167 */
166 static QString familyNameLabel(); 168 static QString familyNameLabel();
167 169
168 /** 170 /**
169 Set given name. 171 Set given name.
170 */ 172 */
171 void setGivenName( const QString &givenName ); 173 void setGivenName( const QString &givenName );
172 /** 174 /**
173 Return given name. 175 Return given name.
174 */ 176 */
175 QString givenName() const; 177 QString givenName() const;
176 /** 178 /**
177 Return translated label for givenName field. 179 Return translated label for givenName field.
178 */ 180 */
179 static QString givenNameLabel(); 181 static QString givenNameLabel();
180 182
181 /** 183 /**
182 Set additional names. 184 Set additional names.
183 */ 185 */
184 void setAdditionalName( const QString &additionalName ); 186 void setAdditionalName( const QString &additionalName );
185 /** 187 /**
186 Return additional names. 188 Return additional names.
187 */ 189 */
188 QString additionalName() const; 190 QString additionalName() const;
189 /** 191 /**
190 Return translated label for additionalName field. 192 Return translated label for additionalName field.
191 */ 193 */
192 static QString additionalNameLabel(); 194 static QString additionalNameLabel();
193 195
194 /** 196 /**
195 Set honorific prefixes. 197 Set honorific prefixes.
196 */ 198 */
197 void setPrefix( const QString &prefix ); 199 void setPrefix( const QString &prefix );
198 /** 200 /**
199 Return honorific prefixes. 201 Return honorific prefixes.
200 */ 202 */
201 QString prefix() const; 203 QString prefix() const;
202 /** 204 /**
203 Return translated label for prefix field. 205 Return translated label for prefix field.
204 */ 206 */
205 static QString prefixLabel(); 207 static QString prefixLabel();
206 208
207 /** 209 /**
208 Set honorific suffixes. 210 Set honorific suffixes.
209 */ 211 */
210 void setSuffix( const QString &suffix ); 212 void setSuffix( const QString &suffix );
211 /** 213 /**
212 Return honorific suffixes. 214 Return honorific suffixes.
213 */ 215 */
214 QString suffix() const; 216 QString suffix() const;
215 /** 217 /**
216 Return translated label for suffix field. 218 Return translated label for suffix field.
217 */ 219 */
218 static QString suffixLabel(); 220 static QString suffixLabel();
219 221
220 /** 222 /**
221 Set nick name. 223 Set nick name.
222 */ 224 */
223 void setNickName( const QString &nickName ); 225 void setNickName( const QString &nickName );
224 /** 226 /**
225 Return nick name. 227 Return nick name.
226 */ 228 */
227 QString nickName() const; 229 QString nickName() const;
228 /** 230 /**
229 Return translated label for nickName field. 231 Return translated label for nickName field.
230 */ 232 */
231 static QString nickNameLabel(); 233 static QString nickNameLabel();
232 234
233 /** 235 /**
234 Set birthday. 236 Set birthday.
235 */ 237 */
236 void setBirthday( const QDateTime &birthday ); 238 void setBirthday( const QDateTime &birthday );
237 /** 239 /**
238 Return birthday. 240 Return birthday.
239 */ 241 */
240 QDateTime birthday() const; 242 QDateTime birthday() const;
241 /** 243 /**
242 Return translated label for birthday field. 244 Return translated label for birthday field.
243 */ 245 */
244 static QString birthdayLabel(); 246 static QString birthdayLabel();
245 247
246 /** 248 /**
247 Return translated label for homeAddressStreet field. 249 Return translated label for homeAddressStreet field.
248 */ 250 */
249 static QString homeAddressStreetLabel(); 251 static QString homeAddressStreetLabel();
250 252
251 /** 253 /**
252 Return translated label for homeAddressLocality field. 254 Return translated label for homeAddressLocality field.
253 */ 255 */
254 static QString homeAddressLocalityLabel(); 256 static QString homeAddressLocalityLabel();
255 257
256 /** 258 /**
257 Return translated label for homeAddressRegion field. 259 Return translated label for homeAddressRegion field.
258 */ 260 */
259 static QString homeAddressRegionLabel(); 261 static QString homeAddressRegionLabel();
260 262
261 /** 263 /**
262 Return translated label for homeAddressPostalCode field. 264 Return translated label for homeAddressPostalCode field.
263 */ 265 */
264 static QString homeAddressPostalCodeLabel(); 266 static QString homeAddressPostalCodeLabel();
265 267
266 /** 268 /**
267 Return translated label for homeAddressCountry field. 269 Return translated label for homeAddressCountry field.
268 */ 270 */
269 static QString homeAddressCountryLabel(); 271 static QString homeAddressCountryLabel();
270 272
271 /** 273 /**
272 Return translated label for homeAddressLabel field. 274 Return translated label for homeAddressLabel field.
273 */ 275 */
274 static QString homeAddressLabelLabel(); 276 static QString homeAddressLabelLabel();
275 277
276 /** 278 /**
277 Return translated label for businessAddressStreet field. 279 Return translated label for businessAddressStreet field.
278 */ 280 */
279 static QString businessAddressStreetLabel(); 281 static QString businessAddressStreetLabel();
280 282
281 /** 283 /**
282 Return translated label for businessAddressLocality field. 284 Return translated label for businessAddressLocality field.
283 */ 285 */
284 static QString businessAddressLocalityLabel(); 286 static QString businessAddressLocalityLabel();
285 287
286 /** 288 /**
287 Return translated label for businessAddressRegion field. 289 Return translated label for businessAddressRegion field.
288 */ 290 */
289 static QString businessAddressRegionLabel(); 291 static QString businessAddressRegionLabel();
290 292
291 /** 293 /**
292 Return translated label for businessAddressPostalCode field. 294 Return translated label for businessAddressPostalCode field.
293 */ 295 */
294 static QString businessAddressPostalCodeLabel(); 296 static QString businessAddressPostalCodeLabel();
295 297
296 /** 298 /**
297 Return translated label for businessAddressCountry field. 299 Return translated label for businessAddressCountry field.
298 */ 300 */
299 static QString businessAddressCountryLabel(); 301 static QString businessAddressCountryLabel();
300 302
301 /** 303 /**
302 Return translated label for businessAddressLabel field. 304 Return translated label for businessAddressLabel field.
303 */ 305 */
304 static QString businessAddressLabelLabel(); 306 static QString businessAddressLabelLabel();
305 307
306 /** 308 /**
307 Return translated label for homePhone field. 309 Return translated label for homePhone field.
308 */ 310 */
309 static QString homePhoneLabel(); 311 static QString homePhoneLabel();
310 312
311 /** 313 /**
312 Return translated label for businessPhone field. 314 Return translated label for businessPhone field.
313 */ 315 */
314 static QString businessPhoneLabel(); 316 static QString businessPhoneLabel();
315 317
316 /** 318 /**
317 Return translated label for mobilePhone field. 319 Return translated label for mobilePhone field.
318 */ 320 */
319 static QString mobilePhoneLabel(); 321 static QString mobilePhoneLabel();
320 322
321 /** 323 /**
322 Return translated label for homeFax field. 324 Return translated label for homeFax field.
323 */ 325 */
324 static QString homeFaxLabel(); 326 static QString homeFaxLabel();
325 327
326 /** 328 /**
327 Return translated label for businessFax field. 329 Return translated label for businessFax field.
328 */ 330 */
329 static QString businessFaxLabel(); 331 static QString businessFaxLabel();
330 332
331 /** 333 /**
332 Return translated label for carPhone field. 334 Return translated label for carPhone field.
333 */ 335 */
334 static QString carPhoneLabel(); 336 static QString carPhoneLabel();
335 337
336 /** 338 /**
337 Return translated label for isdn field. 339 Return translated label for isdn field.
338 */ 340 */
339 static QString isdnLabel(); 341 static QString isdnLabel();
340 342
341 /** 343 /**
342 Return translated label for pager field. 344 Return translated label for pager field.
343 */ 345 */
344 static QString pagerLabel(); 346 static QString pagerLabel();
345 347
346 /** 348 /**
347 Return translated label for sip field. 349 Return translated label for sip field.
348 */ 350 */
349 static QString sipLabel(); 351 static QString sipLabel();
350 352
351 /** 353 /**
352 Return translated label for email field. 354 Return translated label for email field.
353 */ 355 */
354 static QString emailLabel(); 356 static QString emailLabel();
355 357
356 /** 358 /**
357 Set mail client. 359 Set mail client.
358 */ 360 */
359 void setMailer( const QString &mailer ); 361 void setMailer( const QString &mailer );
360 /** 362 /**
361 Return mail client. 363 Return mail client.
362 */ 364 */
363 QString mailer() const; 365 QString mailer() const;
364 /** 366 /**
365 Return translated label for mailer field. 367 Return translated label for mailer field.
366 */ 368 */
367 static QString mailerLabel(); 369 static QString mailerLabel();
368 370
369 /** 371 /**
370 Set time zone. 372 Set time zone.
371 */ 373 */
372 void setTimeZone( const TimeZone &timeZone ); 374 void setTimeZone( const TimeZone &timeZone );
373 /** 375 /**
374 Return time zone. 376 Return time zone.
375 */ 377 */
376 TimeZone timeZone() const; 378 TimeZone timeZone() const;
377 /** 379 /**
378 Return translated label for timeZone field. 380 Return translated label for timeZone field.
379 */ 381 */
380 static QString timeZoneLabel(); 382 static QString timeZoneLabel();
381 383
382 /** 384 /**
383 Set geographic position. 385 Set geographic position.
384 */ 386 */
385 void setGeo( const Geo &geo ); 387 void setGeo( const Geo &geo );
386 /** 388 /**
387 Return geographic position. 389 Return geographic position.
388 */ 390 */
389 Geo geo() const; 391 Geo geo() const;
390 /** 392 /**
391 Return translated label for geo field. 393 Return translated label for geo field.
392 */ 394 */
393 static QString geoLabel(); 395 static QString geoLabel();
394 396
395 /** 397 /**
396 Set title. 398 Set title.
397 */ 399 */
398 void setTitle( const QString &title ); 400 void setTitle( const QString &title );
399 /** 401 /**
400 Return title. 402 Return title.
401 */ 403 */
402 QString title() const; 404 QString title() const;
403 /** 405 /**
404 Return translated label for title field. 406 Return translated label for title field.
405 */ 407 */
406 static QString titleLabel(); 408 static QString titleLabel();
407 409
408 /** 410 /**
409 Set role. 411 Set role.
410 */ 412 */
411 void setRole( const QString &role ); 413 void setRole( const QString &role );
412 /** 414 /**
413 Return role. 415 Return role.
414 */ 416 */
415 QString role() const; 417 QString role() const;
416 /** 418 /**
417 Return translated label for role field. 419 Return translated label for role field.
418 */ 420 */
419 static QString roleLabel(); 421 static QString roleLabel();
420 422
421 /** 423 /**
422 Set organization. 424 Set organization.
423 */ 425 */
424 void setOrganization( const QString &organization ); 426 void setOrganization( const QString &organization );
425 /** 427 /**
426 Return organization. 428 Return organization.
427 */ 429 */
428 QString organization() const; 430 QString organization() const;
429 /** 431 /**
430 Return translated label for organization field. 432 Return translated label for organization field.
431 */ 433 */
432 static QString organizationLabel(); 434 static QString organizationLabel();
433 435
434 /** 436 /**
435 Set note. 437 Set note.
436 */ 438 */
437 void setNote( const QString &note ); 439 void setNote( const QString &note );
438 /** 440 /**
439 Return note. 441 Return note.
440 */ 442 */
441 QString note() const; 443 QString note() const;
442 /** 444 /**
443 Return translated label for note field. 445 Return translated label for note field.
444 */ 446 */
445 static QString noteLabel(); 447 static QString noteLabel();
446 448
447 /** 449 /**
448 Set product identifier. 450 Set product identifier.
449 */ 451 */
450 void setProductId( const QString &productId ); 452 void setProductId( const QString &productId );
451 /** 453 /**
452 Return product identifier. 454 Return product identifier.
453 */ 455 */
454 QString productId() const; 456 QString productId() const;
455 /** 457 /**
456 Return translated label for productId field. 458 Return translated label for productId field.
457 */ 459 */
458 static QString productIdLabel(); 460 static QString productIdLabel();
459 461
460 /** 462 /**
461 Set revision date. 463 Set revision date.
462 */ 464 */
463 void setRevision( const QDateTime &revision ); 465 void setRevision( const QDateTime &revision );
464 /** 466 /**
465 Return revision date. 467 Return revision date.
466 */ 468 */
467 QDateTime revision() const; 469 QDateTime revision() const;
468 /** 470 /**
469 Return translated label for revision field. 471 Return translated label for revision field.
470 */ 472 */
471 static QString revisionLabel(); 473 static QString revisionLabel();
472 474
473 /** 475 /**
474 Set sort string. 476 Set sort string.
475 */ 477 */
476 void setSortString( const QString &sortString ); 478 void setSortString( const QString &sortString );
477 /** 479 /**
478 Return sort string. 480 Return sort string.
479 */ 481 */
480 QString sortString() const; 482 QString sortString() const;
481 /** 483 /**
482 Return translated label for sortString field. 484 Return translated label for sortString field.
483 */ 485 */
484 static QString sortStringLabel(); 486 static QString sortStringLabel();
485 487
486 /** 488 /**
487 Set URL. 489 Set URL.
488 */ 490 */
489 void setUrl( const KURL &url ); 491 void setUrl( const KURL &url );
490 /** 492 /**
491 Return URL. 493 Return URL.
492 */ 494 */
493 KURL url() const; 495 KURL url() const;
494 /** 496 /**
495 Return translated label for url field. 497 Return translated label for url field.
496 */ 498 */
497 static QString urlLabel(); 499 static QString urlLabel();
498 500
499 /** 501 /**