summaryrefslogtreecommitdiffabout
path: root/kabc/addressee.h
Unidiff
Diffstat (limited to 'kabc/addressee.h') (more/less context) (ignore whitespace changes)
-rw-r--r--kabc/addressee.h4
1 files changed, 4 insertions, 0 deletions
diff --git a/kabc/addressee.h b/kabc/addressee.h
index 8baa888..4cafa86 100644
--- a/kabc/addressee.h
+++ b/kabc/addressee.h
@@ -1,631 +1,635 @@
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 void setExternalUID( const QString &id ); 115 void setExternalUID( const QString &id );
116 QString externalUID() const; 116 QString externalUID() const;
117 void setOriginalExternalUID( const QString &id ); 117 void setOriginalExternalUID( const QString &id );
118 QString originalExternalUID() const; 118 QString originalExternalUID() const;
119 void mergeContact( const Addressee& ad ); 119 void mergeContact( const Addressee& ad );
120 void simplifyEmails();
121 void simplifyPhoneNumbers();
122 void simplifyPhoneNumberTypes();
123
120 /** 124 /**
121 Set unique identifier. 125 Set unique identifier.
122 */ 126 */
123 void setUid( const QString &uid ); 127 void setUid( const QString &uid );
124 /** 128 /**
125 Return unique identifier. 129 Return unique identifier.
126 */ 130 */
127 QString uid() const; 131 QString uid() const;
128 /** 132 /**
129 Return translated label for uid field. 133 Return translated label for uid field.
130 */ 134 */
131 static QString uidLabel(); 135 static QString uidLabel();
132 136
133 /** 137 /**
134 Set name. 138 Set name.
135 */ 139 */
136 void setName( const QString &name ); 140 void setName( const QString &name );
137 /** 141 /**
138 Return name. 142 Return name.
139 */ 143 */
140 QString name() const; 144 QString name() const;
141 /** 145 /**
142 Return translated label for name field. 146 Return translated label for name field.
143 */ 147 */
144 static QString nameLabel(); 148 static QString nameLabel();
145 149
146 /** 150 /**
147 Set formatted name. 151 Set formatted name.
148 */ 152 */
149 void setFormattedName( const QString &formattedName ); 153 void setFormattedName( const QString &formattedName );
150 /** 154 /**
151 Return formatted name. 155 Return formatted name.
152 */ 156 */
153 QString formattedName() const; 157 QString formattedName() const;
154 /** 158 /**
155 Return translated label for formattedName field. 159 Return translated label for formattedName field.
156 */ 160 */
157 static QString formattedNameLabel(); 161 static QString formattedNameLabel();
158 162
159 /** 163 /**
160 Set family name. 164 Set family name.
161 */ 165 */
162 void setFamilyName( const QString &familyName ); 166 void setFamilyName( const QString &familyName );
163 /** 167 /**
164 Return family name. 168 Return family name.
165 */ 169 */
166 QString familyName() const; 170 QString familyName() const;
167 /** 171 /**
168 Return translated label for familyName field. 172 Return translated label for familyName field.
169 */ 173 */
170 static QString familyNameLabel(); 174 static QString familyNameLabel();
171 175
172 /** 176 /**
173 Set given name. 177 Set given name.
174 */ 178 */
175 void setGivenName( const QString &givenName ); 179 void setGivenName( const QString &givenName );
176 /** 180 /**
177 Return given name. 181 Return given name.
178 */ 182 */
179 QString givenName() const; 183 QString givenName() const;
180 /** 184 /**
181 Return translated label for givenName field. 185 Return translated label for givenName field.
182 */ 186 */
183 static QString givenNameLabel(); 187 static QString givenNameLabel();
184 188
185 /** 189 /**
186 Set additional names. 190 Set additional names.
187 */ 191 */
188 void setAdditionalName( const QString &additionalName ); 192 void setAdditionalName( const QString &additionalName );
189 /** 193 /**
190 Return additional names. 194 Return additional names.
191 */ 195 */
192 QString additionalName() const; 196 QString additionalName() const;
193 /** 197 /**
194 Return translated label for additionalName field. 198 Return translated label for additionalName field.
195 */ 199 */
196 static QString additionalNameLabel(); 200 static QString additionalNameLabel();
197 201
198 /** 202 /**
199 Set honorific prefixes. 203 Set honorific prefixes.
200 */ 204 */
201 void setPrefix( const QString &prefix ); 205 void setPrefix( const QString &prefix );
202 /** 206 /**
203 Return honorific prefixes. 207 Return honorific prefixes.
204 */ 208 */
205 QString prefix() const; 209 QString prefix() const;
206 /** 210 /**
207 Return translated label for prefix field. 211 Return translated label for prefix field.
208 */ 212 */
209 static QString prefixLabel(); 213 static QString prefixLabel();
210 214
211 /** 215 /**
212 Set honorific suffixes. 216 Set honorific suffixes.
213 */ 217 */
214 void setSuffix( const QString &suffix ); 218 void setSuffix( const QString &suffix );
215 /** 219 /**
216 Return honorific suffixes. 220 Return honorific suffixes.
217 */ 221 */
218 QString suffix() const; 222 QString suffix() const;
219 /** 223 /**
220 Return translated label for suffix field. 224 Return translated label for suffix field.
221 */ 225 */
222 static QString suffixLabel(); 226 static QString suffixLabel();
223 227
224 /** 228 /**
225 Set nick name. 229 Set nick name.
226 */ 230 */
227 void setNickName( const QString &nickName ); 231 void setNickName( const QString &nickName );
228 /** 232 /**
229 Return nick name. 233 Return nick name.
230 */ 234 */
231 QString nickName() const; 235 QString nickName() const;
232 /** 236 /**
233 Return translated label for nickName field. 237 Return translated label for nickName field.
234 */ 238 */
235 static QString nickNameLabel(); 239 static QString nickNameLabel();
236 240
237 /** 241 /**
238 Set birthday. 242 Set birthday.
239 */ 243 */
240 void setBirthday( const QDateTime &birthday ); 244 void setBirthday( const QDateTime &birthday );
241 /** 245 /**
242 Return birthday. 246 Return birthday.
243 */ 247 */
244 QDateTime birthday() const; 248 QDateTime birthday() const;
245 /** 249 /**
246 Return translated label for birthday field. 250 Return translated label for birthday field.
247 */ 251 */
248 static QString birthdayLabel(); 252 static QString birthdayLabel();
249 253
250 /** 254 /**
251 Return translated label for homeAddressStreet field. 255 Return translated label for homeAddressStreet field.
252 */ 256 */
253 static QString homeAddressStreetLabel(); 257 static QString homeAddressStreetLabel();
254 258
255 /** 259 /**
256 Return translated label for homeAddressLocality field. 260 Return translated label for homeAddressLocality field.
257 */ 261 */
258 static QString homeAddressLocalityLabel(); 262 static QString homeAddressLocalityLabel();
259 263
260 /** 264 /**
261 Return translated label for homeAddressRegion field. 265 Return translated label for homeAddressRegion field.
262 */ 266 */
263 static QString homeAddressRegionLabel(); 267 static QString homeAddressRegionLabel();
264 268
265 /** 269 /**
266 Return translated label for homeAddressPostalCode field. 270 Return translated label for homeAddressPostalCode field.
267 */ 271 */
268 static QString homeAddressPostalCodeLabel(); 272 static QString homeAddressPostalCodeLabel();
269 273
270 /** 274 /**
271 Return translated label for homeAddressCountry field. 275 Return translated label for homeAddressCountry field.
272 */ 276 */
273 static QString homeAddressCountryLabel(); 277 static QString homeAddressCountryLabel();
274 278
275 /** 279 /**
276 Return translated label for homeAddressLabel field. 280 Return translated label for homeAddressLabel field.
277 */ 281 */
278 static QString homeAddressLabelLabel(); 282 static QString homeAddressLabelLabel();
279 283
280 /** 284 /**
281 Return translated label for businessAddressStreet field. 285 Return translated label for businessAddressStreet field.
282 */ 286 */
283 static QString businessAddressStreetLabel(); 287 static QString businessAddressStreetLabel();
284 288
285 /** 289 /**
286 Return translated label for businessAddressLocality field. 290 Return translated label for businessAddressLocality field.
287 */ 291 */
288 static QString businessAddressLocalityLabel(); 292 static QString businessAddressLocalityLabel();
289 293
290 /** 294 /**
291 Return translated label for businessAddressRegion field. 295 Return translated label for businessAddressRegion field.
292 */ 296 */
293 static QString businessAddressRegionLabel(); 297 static QString businessAddressRegionLabel();
294 298
295 /** 299 /**
296 Return translated label for businessAddressPostalCode field. 300 Return translated label for businessAddressPostalCode field.
297 */ 301 */
298 static QString businessAddressPostalCodeLabel(); 302 static QString businessAddressPostalCodeLabel();
299 303
300 /** 304 /**
301 Return translated label for businessAddressCountry field. 305 Return translated label for businessAddressCountry field.
302 */ 306 */
303 static QString businessAddressCountryLabel(); 307 static QString businessAddressCountryLabel();
304 308
305 /** 309 /**
306 Return translated label for businessAddressLabel field. 310 Return translated label for businessAddressLabel field.
307 */ 311 */
308 static QString businessAddressLabelLabel(); 312 static QString businessAddressLabelLabel();
309 313
310 /** 314 /**
311 Return translated label for homePhone field. 315 Return translated label for homePhone field.
312 */ 316 */
313 static QString homePhoneLabel(); 317 static QString homePhoneLabel();
314 318
315 /** 319 /**
316 Return translated label for businessPhone field. 320 Return translated label for businessPhone field.
317 */ 321 */
318 static QString businessPhoneLabel(); 322 static QString businessPhoneLabel();
319 323
320 /** 324 /**
321 Return translated label for mobilePhone field. 325 Return translated label for mobilePhone field.
322 */ 326 */
323 static QString mobilePhoneLabel(); 327 static QString mobilePhoneLabel();
324 328
325 /** 329 /**
326 Return translated label for homeFax field. 330 Return translated label for homeFax field.
327 */ 331 */
328 static QString homeFaxLabel(); 332 static QString homeFaxLabel();
329 333
330 /** 334 /**
331 Return translated label for businessFax field. 335 Return translated label for businessFax field.
332 */ 336 */
333 static QString businessFaxLabel(); 337 static QString businessFaxLabel();
334 338
335 /** 339 /**
336 Return translated label for carPhone field. 340 Return translated label for carPhone field.
337 */ 341 */
338 static QString carPhoneLabel(); 342 static QString carPhoneLabel();
339 343
340 /** 344 /**
341 Return translated label for isdn field. 345 Return translated label for isdn field.
342 */ 346 */
343 static QString isdnLabel(); 347 static QString isdnLabel();
344 348
345 /** 349 /**
346 Return translated label for pager field. 350 Return translated label for pager field.
347 */ 351 */
348 static QString pagerLabel(); 352 static QString pagerLabel();
349 353
350 /** 354 /**
351 Return translated label for sip field. 355 Return translated label for sip field.
352 */ 356 */
353 static QString sipLabel(); 357 static QString sipLabel();
354 358
355 /** 359 /**
356 Return translated label for email field. 360 Return translated label for email field.
357 */ 361 */
358 static QString emailLabel(); 362 static QString emailLabel();
359 363
360 /** 364 /**
361 Set mail client. 365 Set mail client.
362 */ 366 */
363 void setMailer( const QString &mailer ); 367 void setMailer( const QString &mailer );
364 /** 368 /**
365 Return mail client. 369 Return mail client.
366 */ 370 */
367 QString mailer() const; 371 QString mailer() const;
368 /** 372 /**
369 Return translated label for mailer field. 373 Return translated label for mailer field.
370 */ 374 */
371 static QString mailerLabel(); 375 static QString mailerLabel();
372 376
373 /** 377 /**
374 Set time zone. 378 Set time zone.
375 */ 379 */
376 void setTimeZone( const TimeZone &timeZone ); 380 void setTimeZone( const TimeZone &timeZone );
377 /** 381 /**
378 Return time zone. 382 Return time zone.
379 */ 383 */
380 TimeZone timeZone() const; 384 TimeZone timeZone() const;
381 /** 385 /**
382 Return translated label for timeZone field. 386 Return translated label for timeZone field.
383 */ 387 */
384 static QString timeZoneLabel(); 388 static QString timeZoneLabel();
385 389
386 /** 390 /**
387 Set geographic position. 391 Set geographic position.
388 */ 392 */
389 void setGeo( const Geo &geo ); 393 void setGeo( const Geo &geo );
390 /** 394 /**
391 Return geographic position. 395 Return geographic position.
392 */ 396 */
393 Geo geo() const; 397 Geo geo() const;
394 /** 398 /**
395 Return translated label for geo field. 399 Return translated label for geo field.
396 */ 400 */
397 static QString geoLabel(); 401 static QString geoLabel();
398 402
399 /** 403 /**
400 Set title. 404 Set title.
401 */ 405 */
402 void setTitle( const QString &title ); 406 void setTitle( const QString &title );
403 /** 407 /**
404 Return title. 408 Return title.
405 */ 409 */
406 QString title() const; 410 QString title() const;
407 /** 411 /**
408 Return translated label for title field. 412 Return translated label for title field.
409 */ 413 */
410 static QString titleLabel(); 414 static QString titleLabel();
411 415
412 /** 416 /**
413 Set role. 417 Set role.
414 */ 418 */
415 void setRole( const QString &role ); 419 void setRole( const QString &role );
416 /** 420 /**
417 Return role. 421 Return role.
418 */ 422 */
419 QString role() const; 423 QString role() const;
420 /** 424 /**
421 Return translated label for role field. 425 Return translated label for role field.
422 */ 426 */
423 static QString roleLabel(); 427 static QString roleLabel();
424 428
425 /** 429 /**
426 Set organization. 430 Set organization.
427 */ 431 */
428 void setOrganization( const QString &organization ); 432 void setOrganization( const QString &organization );
429 /** 433 /**
430 Return organization. 434 Return organization.
431 */ 435 */
432 QString organization() const; 436 QString organization() const;
433 /** 437 /**
434 Return translated label for organization field. 438 Return translated label for organization field.
435 */ 439 */
436 static QString organizationLabel(); 440 static QString organizationLabel();
437 441
438 /** 442 /**
439 Set note. 443 Set note.
440 */ 444 */
441 void setNote( const QString &note ); 445 void setNote( const QString &note );
442 /** 446 /**
443 Return note. 447 Return note.
444 */ 448 */
445 QString note() const; 449 QString note() const;
446 /** 450 /**
447 Return translated label for note field. 451 Return translated label for note field.
448 */ 452 */
449 static QString noteLabel(); 453 static QString noteLabel();
450 454
451 /** 455 /**
452 Set product identifier. 456 Set product identifier.
453 */ 457 */
454 void setProductId( const QString &productId ); 458 void setProductId( const QString &productId );
455 /** 459 /**
456 Return product identifier. 460 Return product identifier.
457 */ 461 */
458 QString productId() const; 462 QString productId() const;
459 /** 463 /**
460 Return translated label for productId field. 464 Return translated label for productId field.
461 */ 465 */
462 static QString productIdLabel(); 466 static QString productIdLabel();
463 467
464 /** 468 /**
465 Set revision date. 469 Set revision date.
466 */ 470 */
467 void setRevision( const QDateTime &revision ); 471 void setRevision( const QDateTime &revision );
468 /** 472 /**
469 Return revision date. 473 Return revision date.
470 */ 474 */
471 QDateTime revision() const; 475 QDateTime revision() const;
472 /** 476 /**
473 Return translated label for revision field. 477 Return translated label for revision field.
474 */ 478 */
475 static QString revisionLabel(); 479 static QString revisionLabel();
476 480
477 /** 481 /**
478 Set sort string. 482 Set sort string.
479 */ 483 */
480 void setSortString( const QString &sortString ); 484 void setSortString( const QString &sortString );
481 /** 485 /**
482 Return sort string. 486 Return sort string.
483 */ 487 */
484 QString sortString() const; 488 QString sortString() const;
485 /** 489 /**
486 Return translated label for sortString field. 490 Return translated label for sortString field.
487 */ 491 */
488 static QString sortStringLabel(); 492 static QString sortStringLabel();
489 493
490 /** 494 /**
491 Set URL. 495 Set URL.
492 */ 496 */
493 void setUrl( const KURL &url ); 497 void setUrl( const KURL &url );
494 /** 498 /**
495 Return URL. 499 Return URL.
496 */ 500 */
497 KURL url() const; 501 KURL url() const;
498 /** 502 /**
499 Return translated label for url field. 503 Return translated label for url field.
500 */ 504 */
501 static QString urlLabel(); 505 static QString urlLabel();
502 506
503 /** 507 /**
504 Set security class. 508 Set security class.
505 */ 509 */
506 void setSecrecy( const Secrecy &secrecy ); 510 void setSecrecy( const Secrecy &secrecy );
507 /** 511 /**
508 Return security class. 512 Return security class.
509 */ 513 */
510 Secrecy secrecy() const; 514 Secrecy secrecy() const;
511 /** 515 /**
512 Return translated label for secrecy field. 516 Return translated label for secrecy field.
513 */ 517 */
514 static QString secrecyLabel(); 518 static QString secrecyLabel();
515 519
516 /** 520 /**
517 Set logo. 521 Set logo.
518 */ 522 */
519 void setLogo( const Picture &logo ); 523 void setLogo( const Picture &logo );
520 /** 524 /**
521 Return logo. 525 Return logo.
522 */ 526 */
523 Picture logo() const; 527 Picture logo() const;
524 /** 528 /**
525 Return translated label for logo field. 529 Return translated label for logo field.
526 */ 530 */
527 static QString logoLabel(); 531 static QString logoLabel();
528 532
529 /** 533 /**
530 Set photo. 534 Set photo.
531 */ 535 */
532 void setPhoto( const Picture &photo ); 536 void setPhoto( const Picture &photo );
533 /** 537 /**
534 Return photo. 538 Return photo.
535 */ 539 */
536 Picture photo() const; 540 Picture photo() const;
537 /** 541 /**
538 Return translated label for photo field. 542 Return translated label for photo field.
539 */ 543 */
540 static QString photoLabel(); 544 static QString photoLabel();
541 545
542 /** 546 /**
543 Set sound. 547 Set sound.
544 */ 548 */
545 void setSound( const Sound &sound ); 549 void setSound( const Sound &sound );
546 /** 550 /**
547 Return sound. 551 Return sound.
548 */ 552 */
549 Sound sound() const; 553 Sound sound() const;
550 /** 554 /**
551 Return translated label for sound field. 555 Return translated label for sound field.
552 */ 556 */
553 static QString soundLabel(); 557 static QString soundLabel();
554 558
555 /** 559 /**
556 Set agent. 560 Set agent.
557 */ 561 */
558 void setAgent( const Agent &agent ); 562 void setAgent( const Agent &agent );
559 /** 563 /**
560 Return agent. 564 Return agent.
561 */ 565 */
562 Agent agent() const; 566 Agent agent() const;
563 /** 567 /**
564 Return translated label for agent field. 568 Return translated label for agent field.
565 */ 569 */
566 static QString agentLabel(); 570 static QString agentLabel();
567 571
568 /** 572 /**
569 Set name fields by parsing the given string and trying to associate the 573 Set name fields by parsing the given string and trying to associate the
570 parts of the string with according fields. This function should probably 574 parts of the string with according fields. This function should probably
571 be a bit more clever. 575 be a bit more clever.
572 */ 576 */
573 void setNameFromString( const QString & ); 577 void setNameFromString( const QString & );
574 578
575 /** 579 /**
576 Return the name of the addressee. This is calculated from all the name 580 Return the name of the addressee. This is calculated from all the name
577 fields. 581 fields.
578 */ 582 */
579 QString realName() const; 583 QString realName() const;
580 584
581 /** 585 /**
582 Return the name that consists of all name parts. 586 Return the name that consists of all name parts.
583 */ 587 */
584 QString assembledName() const; 588 QString assembledName() const;
585 589
586 /** 590 /**
587 Return email address including real name. 591 Return email address including real name.
588 592
589 @param email Email address to be used to construct the full email string. 593 @param email Email address to be used to construct the full email string.
590 If this is QString::null the preferred email address is used. 594 If this is QString::null the preferred email address is used.
591 */ 595 */
592 QString fullEmail( const QString &email=QString::null ) const; 596 QString fullEmail( const QString &email=QString::null ) const;
593 597
594 /** 598 /**
595 Insert an email address. If the email address already exists in this 599 Insert an email address. If the email address already exists in this
596 addressee it is not duplicated. 600 addressee it is not duplicated.
597 601
598 @param email Email address 602 @param email Email address
599 @param preferred Set to true, if this is the preferred email address of 603 @param preferred Set to true, if this is the preferred email address of
600 the addressee. 604 the addressee.
601 */ 605 */
602 void insertEmail( const QString &email, bool preferred=false ); 606 void insertEmail( const QString &email, bool preferred=false );
603 607
604 /** 608 /**
605 Remove email address. If the email address doesn't exist, nothing happens. 609 Remove email address. If the email address doesn't exist, nothing happens.
606 */ 610 */
607 void removeEmail( const QString &email ); 611 void removeEmail( const QString &email );
608 612
609 /** 613 /**
610 Return preferred email address. This is the first email address or the 614 Return preferred email address. This is the first email address or the
611 last one added with @ref insertEmail() with a set preferred parameter. 615 last one added with @ref insertEmail() with a set preferred parameter.
612 */ 616 */
613 QString preferredEmail() const; 617 QString preferredEmail() const;
614 618
615 /** 619 /**
616 Return list of all email addresses. 620 Return list of all email addresses.
617 */ 621 */
618 QStringList emails() const; 622 QStringList emails() const;
619 623
620 /** 624 /**
621 Set the emails to @param. 625 Set the emails to @param.
622 The first email address gets the preferred one! 626 The first email address gets the preferred one!
623 @param list The list of email addresses. 627 @param list The list of email addresses.
624 */ 628 */
625 void setEmails( const QStringList& list); 629 void setEmails( const QStringList& list);
626 630
627 /** 631 /**
628 Insert a phone number. If a phone number with the same id already exists 632 Insert a phone number. If a phone number with the same id already exists
629 in this addressee it is not duplicated. 633 in this addressee it is not duplicated.
630 */ 634 */
631 void insertPhoneNumber( const PhoneNumber &phoneNumber ); 635 void insertPhoneNumber( const PhoneNumber &phoneNumber );