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, 2 insertions, 2 deletions
diff --git a/kabc/addressee.h b/kabc/addressee.h
index 0ea1803..30dcd5d 100644
--- a/kabc/addressee.h
+++ b/kabc/addressee.h
@@ -1,471 +1,471 @@
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 <qregexp.h> 34#include <qregexp.h>
35#include <qstringlist.h> 35#include <qstringlist.h>
36#include <qvaluelist.h> 36#include <q3valuelist.h>
37 37
38#include <ksharedptr.h> 38#include <ksharedptr.h>
39#include <kurl.h> 39#include <kurl.h>
40 40
41#include "address.h" 41#include "address.h"
42#include "agent.h" 42#include "agent.h"
43#include "geo.h" 43#include "geo.h"
44#include "key.h" 44#include "key.h"
45#include "phonenumber.h" 45#include "phonenumber.h"
46#include "picture.h" 46#include "picture.h"
47#include "secrecy.h" 47#include "secrecy.h"
48#include "sound.h" 48#include "sound.h"
49#include "timezone.h" 49#include "timezone.h"
50 50
51namespace KABC { 51namespace KABC {
52 52
53class Resource; 53class Resource;
54 54
55/** 55/**
56 @short address book entry 56 @short address book entry
57 57
58 This class represents an entry in the address book. 58 This class represents an entry in the address book.
59 59
60 The data of this class is implicitly shared. You can pass this class by value. 60 The data of this class is implicitly shared. You can pass this class by value.
61 61
62 If you need the name of a field for presenting it to the user you should use 62 If you need the name of a field for presenting it to the user you should use
63 the functions ending in Label(). They return a translated string which can be 63 the functions ending in Label(). They return a translated string which can be
64 used as label for the corresponding field. 64 used as label for the corresponding field.
65 65
66 About the name fields: 66 About the name fields:
67 67
68 givenName() is the first name and familyName() the last name. In some 68 givenName() is the first name and familyName() the last name. In some
69 countries the family name comes first, that's the reason for the 69 countries the family name comes first, that's the reason for the
70 naming. formattedName() is the full name with the correct formatting. 70 naming. formattedName() is the full name with the correct formatting.
71 It is used as an override, when the correct formatting can't be generated 71 It is used as an override, when the correct formatting can't be generated
72 from the other name fields automatically. 72 from the other name fields automatically.
73 73
74 realName() returns a fully formatted name(). It uses formattedName, if set, 74 realName() returns a fully formatted name(). It uses formattedName, if set,
75 otherwise it constucts the name from the name fields. As fallback, if 75 otherwise it constucts the name from the name fields. As fallback, if
76 nothing else is set it uses name(). 76 nothing else is set it uses name().
77 77
78 name() is the NAME type of RFC2426. It can be used as internal name for the 78 name() is the NAME type of RFC2426. It can be used as internal name for the
79 data enty, but shouldn't be used for displaying the data to the user. 79 data enty, but shouldn't be used for displaying the data to the user.
80 */ 80 */
81class Addressee 81class Addressee
82{ 82{
83 friend QDataStream &operator<<( QDataStream &, const Addressee & ); 83 friend QDataStream &operator<<( QDataStream &, const Addressee & );
84 friend QDataStream &operator>>( QDataStream &, Addressee & ); 84 friend QDataStream &operator>>( QDataStream &, Addressee & );
85 85
86 public: 86 public:
87 typedef QValueList<Addressee> List; 87 typedef Q3ValueList<Addressee> List;
88 88
89 /** 89 /**
90 Construct an empty address book entry. 90 Construct an empty address book entry.
91 */ 91 */
92 Addressee(); 92 Addressee();
93 ~Addressee(); 93 ~Addressee();
94 94
95 Addressee( const Addressee & ); 95 Addressee( const Addressee & );
96 Addressee &operator=( const Addressee & ); 96 Addressee &operator=( const Addressee & );
97 97
98 bool operator==( const Addressee & ) const; 98 bool operator==( const Addressee & ) const;
99 bool operator!=( const Addressee & ) const; 99 bool operator!=( const Addressee & ) const;
100 // sync stuff 100 // sync stuff
101 void setTempSyncStat(int id); 101 void setTempSyncStat(int id);
102 int tempSyncStat() const; 102 int tempSyncStat() const;
103 void setIDStr( const QString & ); 103 void setIDStr( const QString & );
104 const QString IDStr() const; 104 const QString IDStr() const;
105 void setID( const QString &, const QString & ); 105 void setID( const QString &, const QString & );
106 const QString getID( const QString & ) const; 106 const QString getID( const QString & ) const;
107 void setCsum( const QString &, const QString & ); 107 void setCsum( const QString &, const QString & );
108 const QString getCsum( const QString & ) const ; 108 const QString getCsum( const QString & ) const ;
109 void removeID(const QString &); 109 void removeID(const QString &);
110 void computeCsum(const QString &dev); 110 void computeCsum(const QString &dev);
111 ulong getCsum4List( const QStringList & attList); 111 ulong getCsum4List( const QStringList & attList);
112 /** 112 /**
113 Return, if the address book entry is empty. 113 Return, if the address book entry is empty.
114 */ 114 */
115 bool isEmpty() const; 115 bool isEmpty() const;
116 void setExternalUID( const QString &id ); 116 void setExternalUID( const QString &id );
117 const QString externalUID() const; 117 const QString externalUID() const;
118 void setOriginalExternalUID( const QString &id ); 118 void setOriginalExternalUID( const QString &id );
119 QString originalExternalUID() const; 119 QString originalExternalUID() const;
120 void mergeContact( const Addressee& ad, bool isSubSet ); 120 void mergeContact( const Addressee& ad, bool isSubSet );
121 void mergeOLContact( const Addressee& ad ); 121 void mergeOLContact( const Addressee& ad );
122 void simplifyEmails(); 122 void simplifyEmails();
123 void simplifyAddresses(); 123 void simplifyAddresses();
124 void simplifyPhoneNumbers(); 124 void simplifyPhoneNumbers();
125 void simplifyPhoneNumberTypes(); 125 void simplifyPhoneNumberTypes();
126 void makePhoneNumbersOLcompatible(); 126 void makePhoneNumbersOLcompatible();
127 int hasPhoneNumberType( int type ); 127 int hasPhoneNumberType( int type );
128 bool removeVoice(); 128 bool removeVoice();
129 bool containsAdr(const Addressee& addr ); 129 bool containsAdr(const Addressee& addr );
130 130
131 /** 131 /**
132 Set unique identifier. 132 Set unique identifier.
133 */ 133 */
134 void setUid( const QString &uid ); 134 void setUid( const QString &uid );
135 /** 135 /**
136 Return unique identifier. 136 Return unique identifier.
137 */ 137 */
138 const QString uid() const; 138 const QString uid() const;
139 /** 139 /**
140 Return translated label for uid field. 140 Return translated label for uid field.
141 */ 141 */
142 static QString uidLabel(); 142 static QString uidLabel();
143 143
144 /** 144 /**
145 Set name. 145 Set name.
146 */ 146 */
147 void setName( const QString &name ); 147 void setName( const QString &name );
148 /** 148 /**
149 Return name. 149 Return name.
150 */ 150 */
151 QString name() const; 151 QString name() const;
152 /** 152 /**
153 Return translated label for name field. 153 Return translated label for name field.
154 */ 154 */
155 static QString nameLabel(); 155 static QString nameLabel();
156 156
157 /** 157 /**
158 Set formatted name. 158 Set formatted name.
159 */ 159 */
160 void setFormattedName( const QString &formattedName ); 160 void setFormattedName( const QString &formattedName );
161 /** 161 /**
162 Return formatted name. 162 Return formatted name.
163 */ 163 */
164 QString formattedName() const; 164 QString formattedName() const;
165 /** 165 /**
166 Return translated label for formattedName field. 166 Return translated label for formattedName field.
167 */ 167 */
168 static QString formattedNameLabel(); 168 static QString formattedNameLabel();
169 169
170 /** 170 /**
171 Set family name. 171 Set family name.
172 */ 172 */
173 void setFamilyName( const QString &familyName ); 173 void setFamilyName( const QString &familyName );
174 /** 174 /**
175 Return family name. 175 Return family name.
176 */ 176 */
177 QString familyName() const; 177 QString familyName() const;
178 /** 178 /**
179 Return translated label for familyName field. 179 Return translated label for familyName field.
180 */ 180 */
181 static QString familyNameLabel(); 181 static QString familyNameLabel();
182 182
183 /** 183 /**
184 Set given name. 184 Set given name.
185 */ 185 */
186 void setGivenName( const QString &givenName ); 186 void setGivenName( const QString &givenName );
187 /** 187 /**
188 Return given name. 188 Return given name.
189 */ 189 */
190 QString givenName() const; 190 QString givenName() const;
191 /** 191 /**
192 Return translated label for givenName field. 192 Return translated label for givenName field.
193 */ 193 */
194 static QString givenNameLabel(); 194 static QString givenNameLabel();
195 195
196 /** 196 /**
197 Set additional names. 197 Set additional names.
198 */ 198 */
199 void setAdditionalName( const QString &additionalName ); 199 void setAdditionalName( const QString &additionalName );
200 /** 200 /**
201 Return additional names. 201 Return additional names.
202 */ 202 */
203 QString additionalName() const; 203 QString additionalName() const;
204 /** 204 /**
205 Return translated label for additionalName field. 205 Return translated label for additionalName field.
206 */ 206 */
207 static QString additionalNameLabel(); 207 static QString additionalNameLabel();
208 208
209 /** 209 /**
210 Set honorific prefixes. 210 Set honorific prefixes.
211 */ 211 */
212 void setPrefix( const QString &prefix ); 212 void setPrefix( const QString &prefix );
213 /** 213 /**
214 Return honorific prefixes. 214 Return honorific prefixes.
215 */ 215 */
216 QString prefix() const; 216 QString prefix() const;
217 /** 217 /**
218 Return translated label for prefix field. 218 Return translated label for prefix field.
219 */ 219 */
220 static QString prefixLabel(); 220 static QString prefixLabel();
221 221
222 /** 222 /**
223 Set honorific suffixes. 223 Set honorific suffixes.
224 */ 224 */
225 void setSuffix( const QString &suffix ); 225 void setSuffix( const QString &suffix );
226 /** 226 /**
227 Return honorific suffixes. 227 Return honorific suffixes.
228 */ 228 */
229 QString suffix() const; 229 QString suffix() const;
230 /** 230 /**
231 Return translated label for suffix field. 231 Return translated label for suffix field.
232 */ 232 */
233 static QString suffixLabel(); 233 static QString suffixLabel();
234 234
235 /** 235 /**
236 Set nick name. 236 Set nick name.
237 */ 237 */
238 void setNickName( const QString &nickName ); 238 void setNickName( const QString &nickName );
239 /** 239 /**
240 Return nick name. 240 Return nick name.
241 */ 241 */
242 QString nickName() const; 242 QString nickName() const;
243 /** 243 /**
244 Return translated label for nickName field. 244 Return translated label for nickName field.
245 */ 245 */
246 static QString nickNameLabel(); 246 static QString nickNameLabel();
247 247
248 /** 248 /**
249 Set birthday. 249 Set birthday.
250 */ 250 */
251 void setBirthday( const QDateTime &birthday ); 251 void setBirthday( const QDateTime &birthday );
252 /** 252 /**
253 Return birthday. 253 Return birthday.
254 */ 254 */
255 QDateTime birthday() const; 255 QDateTime birthday() const;
256 /** 256 /**
257 Return translated label for birthday field. 257 Return translated label for birthday field.
258 */ 258 */
259 static QString birthdayLabel(); 259 static QString birthdayLabel();
260 260
261 /** 261 /**
262 Return translated label for homeAddressStreet field. 262 Return translated label for homeAddressStreet field.
263 */ 263 */
264 static QString homeAddressStreetLabel(); 264 static QString homeAddressStreetLabel();
265 265
266 /** 266 /**
267 Return translated label for homeAddressLocality field. 267 Return translated label for homeAddressLocality field.
268 */ 268 */
269 static QString homeAddressLocalityLabel(); 269 static QString homeAddressLocalityLabel();
270 270
271 /** 271 /**
272 Return translated label for homeAddressRegion field. 272 Return translated label for homeAddressRegion field.
273 */ 273 */
274 static QString homeAddressRegionLabel(); 274 static QString homeAddressRegionLabel();
275 275
276 /** 276 /**
277 Return translated label for homeAddressPostalCode field. 277 Return translated label for homeAddressPostalCode field.
278 */ 278 */
279 static QString homeAddressPostalCodeLabel(); 279 static QString homeAddressPostalCodeLabel();
280 280
281 /** 281 /**
282 Return translated label for homeAddressCountry field. 282 Return translated label for homeAddressCountry field.
283 */ 283 */
284 static QString homeAddressCountryLabel(); 284 static QString homeAddressCountryLabel();
285 285
286 /** 286 /**
287 Return translated label for homeAddressLabel field. 287 Return translated label for homeAddressLabel field.
288 */ 288 */
289 static QString homeAddressLabelLabel(); 289 static QString homeAddressLabelLabel();
290 290
291 /** 291 /**
292 Return translated label for businessAddressStreet field. 292 Return translated label for businessAddressStreet field.
293 */ 293 */
294 static QString businessAddressStreetLabel(); 294 static QString businessAddressStreetLabel();
295 295
296 /** 296 /**
297 Return translated label for businessAddressLocality field. 297 Return translated label for businessAddressLocality field.
298 */ 298 */
299 static QString businessAddressLocalityLabel(); 299 static QString businessAddressLocalityLabel();
300 300
301 /** 301 /**
302 Return translated label for businessAddressRegion field. 302 Return translated label for businessAddressRegion field.
303 */ 303 */
304 static QString businessAddressRegionLabel(); 304 static QString businessAddressRegionLabel();
305 305
306 /** 306 /**
307 Return translated label for businessAddressPostalCode field. 307 Return translated label for businessAddressPostalCode field.
308 */ 308 */
309 static QString businessAddressPostalCodeLabel(); 309 static QString businessAddressPostalCodeLabel();
310 310
311 /** 311 /**
312 Return translated label for businessAddressCountry field. 312 Return translated label for businessAddressCountry field.
313 */ 313 */
314 static QString businessAddressCountryLabel(); 314 static QString businessAddressCountryLabel();
315 315
316 /** 316 /**
317 Return translated label for businessAddressLabel field. 317 Return translated label for businessAddressLabel field.
318 */ 318 */
319 static QString businessAddressLabelLabel(); 319 static QString businessAddressLabelLabel();
320 320
321 /** 321 /**
322 Return translated label for homePhone field. 322 Return translated label for homePhone field.
323 */ 323 */
324 static QString homePhoneLabel(); 324 static QString homePhoneLabel();
325 325
326 /** 326 /**
327 Return translated label for businessPhone field. 327 Return translated label for businessPhone field.
328 */ 328 */
329 static QString businessPhoneLabel(); 329 static QString businessPhoneLabel();
330 330
331 /** 331 /**
332 Return translated label for mobilePhone field. 332 Return translated label for mobilePhone field.
333 */ 333 */
334 static QString mobilePhoneLabel(); 334 static QString mobilePhoneLabel();
335 static QString mobileWorkPhoneLabel(); 335 static QString mobileWorkPhoneLabel();
336 336
337 /** 337 /**
338 Return translated label for homeFax field. 338 Return translated label for homeFax field.
339 */ 339 */
340 static QString homeFaxLabel(); 340 static QString homeFaxLabel();
341 341
342 /** 342 /**
343 Return translated label for businessFax field. 343 Return translated label for businessFax field.
344 */ 344 */
345 static QString businessFaxLabel(); 345 static QString businessFaxLabel();
346 346
347 347
348 /** 348 /**
349 Return translated label for isdn field. 349 Return translated label for isdn field.
350 */ 350 */
351 static QString isdnLabel(); 351 static QString isdnLabel();
352 352
353 /** 353 /**
354 Return translated label for pager field. 354 Return translated label for pager field.
355 */ 355 */
356 static QString pagerLabel(); 356 static QString pagerLabel();
357 static QString otherPhoneLabel(); 357 static QString otherPhoneLabel();
358 /** 358 /**
359 Return translated label for sip field. 359 Return translated label for sip field.
360 */ 360 */
361 static QString sipLabel(); 361 static QString sipLabel();
362 362
363 /** 363 /**
364 Return translated label for email field. 364 Return translated label for email field.
365 */ 365 */
366 static QString emailLabel(); 366 static QString emailLabel();
367 367
368 /** 368 /**
369 Set mail client. 369 Set mail client.
370 */ 370 */
371 void setMailer( const QString &mailer ); 371 void setMailer( const QString &mailer );
372 /** 372 /**
373 Return mail client. 373 Return mail client.
374 */ 374 */
375 QString mailer() const; 375 QString mailer() const;
376 /** 376 /**
377 Return translated label for mailer field. 377 Return translated label for mailer field.
378 */ 378 */
379 static QString mailerLabel(); 379 static QString mailerLabel();
380 380
381 /** 381 /**
382 Set time zone. 382 Set time zone.
383 */ 383 */
384 void setTimeZone( const TimeZone &timeZone ); 384 void setTimeZone( const TimeZone &timeZone );
385 /** 385 /**
386 Return time zone. 386 Return time zone.
387 */ 387 */
388 TimeZone timeZone() const; 388 TimeZone timeZone() const;
389 /** 389 /**
390 Return translated label for timeZone field. 390 Return translated label for timeZone field.
391 */ 391 */
392 static QString timeZoneLabel(); 392 static QString timeZoneLabel();
393 393
394 /** 394 /**
395 Set geographic position. 395 Set geographic position.
396 */ 396 */
397 void setGeo( const Geo &geo ); 397 void setGeo( const Geo &geo );
398 /** 398 /**
399 Return geographic position. 399 Return geographic position.
400 */ 400 */
401 Geo geo() const; 401 Geo geo() const;
402 /** 402 /**
403 Return translated label for geo field. 403 Return translated label for geo field.
404 */ 404 */
405 static QString geoLabel(); 405 static QString geoLabel();
406 406
407 /** 407 /**
408 Set title. 408 Set title.
409 */ 409 */
410 void setTitle( const QString &title ); 410 void setTitle( const QString &title );
411 /** 411 /**
412 Return title. 412 Return title.
413 */ 413 */
414 QString title() const; 414 QString title() const;
415 /** 415 /**
416 Return translated label for title field. 416 Return translated label for title field.
417 */ 417 */
418 static QString titleLabel(); 418 static QString titleLabel();
419 419
420 /** 420 /**
421 Set role. 421 Set role.
422 */ 422 */
423 void setRole( const QString &role ); 423 void setRole( const QString &role );
424 /** 424 /**
425 Return role. 425 Return role.
426 */ 426 */
427 QString role() const; 427 QString role() const;
428 /** 428 /**
429 Return translated label for role field. 429 Return translated label for role field.
430 */ 430 */
431 static QString roleLabel(); 431 static QString roleLabel();
432 432
433 /** 433 /**
434 Set organization. 434 Set organization.
435 */ 435 */
436 void setOrganization( const QString &organization ); 436 void setOrganization( const QString &organization );
437 /** 437 /**
438 Return organization. 438 Return organization.
439 */ 439 */
440 QString organization() const; 440 QString organization() const;
441 /** 441 /**
442 Return translated label for organization field. 442 Return translated label for organization field.
443 */ 443 */
444 static QString organizationLabel(); 444 static QString organizationLabel();
445 445
446 /** 446 /**
447 Set note. 447 Set note.
448 */ 448 */
449 void setNote( const QString &note ); 449 void setNote( const QString &note );
450 /** 450 /**
451 Return note. 451 Return note.
452 */ 452 */
453 QString note() const; 453 QString note() const;
454 /** 454 /**
455 Return translated label for note field. 455 Return translated label for note field.
456 */ 456 */
457 static QString noteLabel(); 457 static QString noteLabel();
458 458
459 /** 459 /**
460 Set product identifier. 460 Set product identifier.
461 */ 461 */
462 void setProductId( const QString &productId ); 462 void setProductId( const QString &productId );
463 /** 463 /**
464 Return product identifier. 464 Return product identifier.
465 */ 465 */
466 QString productId() const; 466 QString productId() const;
467 /** 467 /**
468 Return translated label for productId field. 468 Return translated label for productId field.
469 */ 469 */
470 static QString productIdLabel(); 470 static QString productIdLabel();
471 471