summaryrefslogtreecommitdiffabout
path: root/kabc/addressee.h
authorzautrix <zautrix>2005-10-28 03:24:50 (UTC)
committer zautrix <zautrix>2005-10-28 03:24:50 (UTC)
commitf83a59cf4f9d0cff4111b6f5c88e88e6dc96e79e (patch) (unidiff)
tree969e6cf85499e3b1dcaa4dc24c972b65c906cfa9 /kabc/addressee.h
parentcbda16d4966c7483d20d1b6b5a64c8af367ea732 (diff)
downloadkdepimpi-f83a59cf4f9d0cff4111b6f5c88e88e6dc96e79e.zip
kdepimpi-f83a59cf4f9d0cff4111b6f5c88e88e6dc96e79e.tar.gz
kdepimpi-f83a59cf4f9d0cff4111b6f5c88e88e6dc96e79e.tar.bz2
many new bugs...
Diffstat (limited to 'kabc/addressee.h') (more/less context) (ignore whitespace changes)
-rw-r--r--kabc/addressee.h2
1 files changed, 2 insertions, 0 deletions
diff --git a/kabc/addressee.h b/kabc/addressee.h
index d1c07cb..0c488eb 100644
--- a/kabc/addressee.h
+++ b/kabc/addressee.h
@@ -1,380 +1,382 @@
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 <qvaluelist.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 QValueList<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 simplifyEmails(); 121 void simplifyEmails();
122 void simplifyAddresses(); 122 void simplifyAddresses();
123 void simplifyPhoneNumbers(); 123 void simplifyPhoneNumbers();
124 void simplifyPhoneNumberTypes(); 124 void simplifyPhoneNumberTypes();
125 void makePhoneNumbersOLcompatible();
126 int hasPhoneNumberType( int type );
125 bool removeVoice(); 127 bool removeVoice();
126 bool containsAdr(const Addressee& addr ); 128 bool containsAdr(const Addressee& addr );
127 129
128 /** 130 /**
129 Set unique identifier. 131 Set unique identifier.
130 */ 132 */
131 void setUid( const QString &uid ); 133 void setUid( const QString &uid );
132 /** 134 /**
133 Return unique identifier. 135 Return unique identifier.
134 */ 136 */
135 const QString uid() const; 137 const QString uid() const;
136 /** 138 /**
137 Return translated label for uid field. 139 Return translated label for uid field.
138 */ 140 */
139 static QString uidLabel(); 141 static QString uidLabel();
140 142
141 /** 143 /**
142 Set name. 144 Set name.
143 */ 145 */
144 void setName( const QString &name ); 146 void setName( const QString &name );
145 /** 147 /**
146 Return name. 148 Return name.
147 */ 149 */
148 QString name() const; 150 QString name() const;
149 /** 151 /**
150 Return translated label for name field. 152 Return translated label for name field.
151 */ 153 */
152 static QString nameLabel(); 154 static QString nameLabel();
153 155
154 /** 156 /**
155 Set formatted name. 157 Set formatted name.
156 */ 158 */
157 void setFormattedName( const QString &formattedName ); 159 void setFormattedName( const QString &formattedName );
158 /** 160 /**
159 Return formatted name. 161 Return formatted name.
160 */ 162 */
161 QString formattedName() const; 163 QString formattedName() const;
162 /** 164 /**
163 Return translated label for formattedName field. 165 Return translated label for formattedName field.
164 */ 166 */
165 static QString formattedNameLabel(); 167 static QString formattedNameLabel();
166 168
167 /** 169 /**
168 Set family name. 170 Set family name.
169 */ 171 */
170 void setFamilyName( const QString &familyName ); 172 void setFamilyName( const QString &familyName );
171 /** 173 /**
172 Return family name. 174 Return family name.
173 */ 175 */
174 QString familyName() const; 176 QString familyName() const;
175 /** 177 /**
176 Return translated label for familyName field. 178 Return translated label for familyName field.
177 */ 179 */
178 static QString familyNameLabel(); 180 static QString familyNameLabel();
179 181
180 /** 182 /**
181 Set given name. 183 Set given name.
182 */ 184 */
183 void setGivenName( const QString &givenName ); 185 void setGivenName( const QString &givenName );
184 /** 186 /**
185 Return given name. 187 Return given name.
186 */ 188 */
187 QString givenName() const; 189 QString givenName() const;
188 /** 190 /**
189 Return translated label for givenName field. 191 Return translated label for givenName field.
190 */ 192 */
191 static QString givenNameLabel(); 193 static QString givenNameLabel();
192 194
193 /** 195 /**
194 Set additional names. 196 Set additional names.
195 */ 197 */
196 void setAdditionalName( const QString &additionalName ); 198 void setAdditionalName( const QString &additionalName );
197 /** 199 /**
198 Return additional names. 200 Return additional names.
199 */ 201 */
200 QString additionalName() const; 202 QString additionalName() const;
201 /** 203 /**
202 Return translated label for additionalName field. 204 Return translated label for additionalName field.
203 */ 205 */
204 static QString additionalNameLabel(); 206 static QString additionalNameLabel();
205 207
206 /** 208 /**
207 Set honorific prefixes. 209 Set honorific prefixes.
208 */ 210 */
209 void setPrefix( const QString &prefix ); 211 void setPrefix( const QString &prefix );
210 /** 212 /**
211 Return honorific prefixes. 213 Return honorific prefixes.
212 */ 214 */
213 QString prefix() const; 215 QString prefix() const;
214 /** 216 /**
215 Return translated label for prefix field. 217 Return translated label for prefix field.
216 */ 218 */
217 static QString prefixLabel(); 219 static QString prefixLabel();
218 220
219 /** 221 /**
220 Set honorific suffixes. 222 Set honorific suffixes.
221 */ 223 */
222 void setSuffix( const QString &suffix ); 224 void setSuffix( const QString &suffix );
223 /** 225 /**
224 Return honorific suffixes. 226 Return honorific suffixes.
225 */ 227 */
226 QString suffix() const; 228 QString suffix() const;
227 /** 229 /**
228 Return translated label for suffix field. 230 Return translated label for suffix field.
229 */ 231 */
230 static QString suffixLabel(); 232 static QString suffixLabel();
231 233
232 /** 234 /**
233 Set nick name. 235 Set nick name.
234 */ 236 */
235 void setNickName( const QString &nickName ); 237 void setNickName( const QString &nickName );
236 /** 238 /**
237 Return nick name. 239 Return nick name.
238 */ 240 */
239 QString nickName() const; 241 QString nickName() const;
240 /** 242 /**
241 Return translated label for nickName field. 243 Return translated label for nickName field.
242 */ 244 */
243 static QString nickNameLabel(); 245 static QString nickNameLabel();
244 246
245 /** 247 /**
246 Set birthday. 248 Set birthday.
247 */ 249 */
248 void setBirthday( const QDateTime &birthday ); 250 void setBirthday( const QDateTime &birthday );
249 /** 251 /**
250 Return birthday. 252 Return birthday.
251 */ 253 */
252 QDateTime birthday() const; 254 QDateTime birthday() const;
253 /** 255 /**
254 Return translated label for birthday field. 256 Return translated label for birthday field.
255 */ 257 */
256 static QString birthdayLabel(); 258 static QString birthdayLabel();
257 259
258 /** 260 /**
259 Return translated label for homeAddressStreet field. 261 Return translated label for homeAddressStreet field.
260 */ 262 */
261 static QString homeAddressStreetLabel(); 263 static QString homeAddressStreetLabel();
262 264
263 /** 265 /**
264 Return translated label for homeAddressLocality field. 266 Return translated label for homeAddressLocality field.
265 */ 267 */
266 static QString homeAddressLocalityLabel(); 268 static QString homeAddressLocalityLabel();
267 269
268 /** 270 /**
269 Return translated label for homeAddressRegion field. 271 Return translated label for homeAddressRegion field.
270 */ 272 */
271 static QString homeAddressRegionLabel(); 273 static QString homeAddressRegionLabel();
272 274
273 /** 275 /**
274 Return translated label for homeAddressPostalCode field. 276 Return translated label for homeAddressPostalCode field.
275 */ 277 */
276 static QString homeAddressPostalCodeLabel(); 278 static QString homeAddressPostalCodeLabel();
277 279
278 /** 280 /**
279 Return translated label for homeAddressCountry field. 281 Return translated label for homeAddressCountry field.
280 */ 282 */
281 static QString homeAddressCountryLabel(); 283 static QString homeAddressCountryLabel();
282 284
283 /** 285 /**
284 Return translated label for homeAddressLabel field. 286 Return translated label for homeAddressLabel field.
285 */ 287 */
286 static QString homeAddressLabelLabel(); 288 static QString homeAddressLabelLabel();
287 289
288 /** 290 /**
289 Return translated label for businessAddressStreet field. 291 Return translated label for businessAddressStreet field.
290 */ 292 */
291 static QString businessAddressStreetLabel(); 293 static QString businessAddressStreetLabel();
292 294
293 /** 295 /**
294 Return translated label for businessAddressLocality field. 296 Return translated label for businessAddressLocality field.
295 */ 297 */
296 static QString businessAddressLocalityLabel(); 298 static QString businessAddressLocalityLabel();
297 299
298 /** 300 /**
299 Return translated label for businessAddressRegion field. 301 Return translated label for businessAddressRegion field.
300 */ 302 */
301 static QString businessAddressRegionLabel(); 303 static QString businessAddressRegionLabel();
302 304
303 /** 305 /**
304 Return translated label for businessAddressPostalCode field. 306 Return translated label for businessAddressPostalCode field.
305 */ 307 */
306 static QString businessAddressPostalCodeLabel(); 308 static QString businessAddressPostalCodeLabel();
307 309
308 /** 310 /**
309 Return translated label for businessAddressCountry field. 311 Return translated label for businessAddressCountry field.
310 */ 312 */
311 static QString businessAddressCountryLabel(); 313 static QString businessAddressCountryLabel();
312 314
313 /** 315 /**
314 Return translated label for businessAddressLabel field. 316 Return translated label for businessAddressLabel field.
315 */ 317 */
316 static QString businessAddressLabelLabel(); 318 static QString businessAddressLabelLabel();
317 319
318 /** 320 /**
319 Return translated label for homePhone field. 321 Return translated label for homePhone field.
320 */ 322 */
321 static QString homePhoneLabel(); 323 static QString homePhoneLabel();
322 324
323 /** 325 /**
324 Return translated label for businessPhone field. 326 Return translated label for businessPhone field.
325 */ 327 */
326 static QString businessPhoneLabel(); 328 static QString businessPhoneLabel();
327 329
328 /** 330 /**
329 Return translated label for mobilePhone field. 331 Return translated label for mobilePhone field.
330 */ 332 */
331 static QString mobilePhoneLabel(); 333 static QString mobilePhoneLabel();
332 static QString mobileWorkPhoneLabel(); 334 static QString mobileWorkPhoneLabel();
333 static QString mobileHomePhoneLabel(); 335 static QString mobileHomePhoneLabel();
334 336
335 /** 337 /**
336 Return translated label for homeFax field. 338 Return translated label for homeFax field.
337 */ 339 */
338 static QString homeFaxLabel(); 340 static QString homeFaxLabel();
339 341
340 /** 342 /**
341 Return translated label for businessFax field. 343 Return translated label for businessFax field.
342 */ 344 */
343 static QString businessFaxLabel(); 345 static QString businessFaxLabel();
344 346
345 /** 347 /**
346 Return translated label for carPhone field. 348 Return translated label for carPhone field.
347 */ 349 */
348 static QString carPhoneLabel(); 350 static QString carPhoneLabel();
349 351
350 /** 352 /**
351 Return translated label for isdn field. 353 Return translated label for isdn field.
352 */ 354 */
353 static QString isdnLabel(); 355 static QString isdnLabel();
354 356
355 /** 357 /**
356 Return translated label for pager field. 358 Return translated label for pager field.
357 */ 359 */
358 static QString pagerLabel(); 360 static QString pagerLabel();
359 361
360 /** 362 /**
361 Return translated label for sip field. 363 Return translated label for sip field.
362 */ 364 */
363 static QString sipLabel(); 365 static QString sipLabel();
364 366
365 /** 367 /**
366 Return translated label for email field. 368 Return translated label for email field.
367 */ 369 */
368 static QString emailLabel(); 370 static QString emailLabel();
369 371
370 /** 372 /**
371 Set mail client. 373 Set mail client.
372 */ 374 */
373 void setMailer( const QString &mailer ); 375 void setMailer( const QString &mailer );
374 /** 376 /**
375 Return mail client. 377 Return mail client.
376 */ 378 */
377 QString mailer() const; 379 QString mailer() const;
378 /** 380 /**
379 Return translated label for mailer field. 381 Return translated label for mailer field.
380 */ 382 */