-rw-r--r-- | kabc/addressee.h | 2 |
1 files changed, 2 insertions, 0 deletions
diff --git a/kabc/addressee.h b/kabc/addressee.h index f098371..0805458 100644 --- a/kabc/addressee.h +++ b/kabc/addressee.h | |||
@@ -61,96 +61,98 @@ class Resource; | |||
61 | If you need the name of a field for presenting it to the user you should use | 61 | If you need the name of a field for presenting it to the user you should use |
62 | the functions ending in Label(). They return a translated string which can be | 62 | the functions ending in Label(). They return a translated string which can be |
63 | used as label for the corresponding field. | 63 | used as label for the corresponding field. |
64 | 64 | ||
65 | About the name fields: | 65 | About the name fields: |
66 | 66 | ||
67 | givenName() is the first name and familyName() the last name. In some | 67 | givenName() is the first name and familyName() the last name. In some |
68 | countries the family name comes first, that's the reason for the | 68 | countries the family name comes first, that's the reason for the |
69 | naming. formattedName() is the full name with the correct formatting. | 69 | naming. formattedName() is the full name with the correct formatting. |
70 | It is used as an override, when the correct formatting can't be generated | 70 | It is used as an override, when the correct formatting can't be generated |
71 | from the other name fields automatically. | 71 | from the other name fields automatically. |
72 | 72 | ||
73 | realName() returns a fully formatted name(). It uses formattedName, if set, | 73 | realName() returns a fully formatted name(). It uses formattedName, if set, |
74 | otherwise it constucts the name from the name fields. As fallback, if | 74 | otherwise it constucts the name from the name fields. As fallback, if |
75 | nothing else is set it uses name(). | 75 | nothing else is set it uses name(). |
76 | 76 | ||
77 | name() is the NAME type of RFC2426. It can be used as internal name for the | 77 | name() is the NAME type of RFC2426. It can be used as internal name for the |
78 | data enty, but shouldn't be used for displaying the data to the user. | 78 | data enty, but shouldn't be used for displaying the data to the user. |
79 | */ | 79 | */ |
80 | class Addressee | 80 | class Addressee |
81 | { | 81 | { |
82 | friend QDataStream &operator<<( QDataStream &, const Addressee & ); | 82 | friend QDataStream &operator<<( QDataStream &, const Addressee & ); |
83 | friend QDataStream &operator>>( QDataStream &, Addressee & ); | 83 | friend QDataStream &operator>>( QDataStream &, Addressee & ); |
84 | 84 | ||
85 | public: | 85 | public: |
86 | typedef QValueList<Addressee> List; | 86 | typedef QValueList<Addressee> List; |
87 | 87 | ||
88 | /** | 88 | /** |
89 | Construct an empty address book entry. | 89 | Construct an empty address book entry. |
90 | */ | 90 | */ |
91 | Addressee(); | 91 | Addressee(); |
92 | ~Addressee(); | 92 | ~Addressee(); |
93 | 93 | ||
94 | Addressee( const Addressee & ); | 94 | Addressee( const Addressee & ); |
95 | Addressee &operator=( const Addressee & ); | 95 | Addressee &operator=( const Addressee & ); |
96 | 96 | ||
97 | bool operator==( const Addressee & ) const; | 97 | bool operator==( const Addressee & ) const; |
98 | bool operator!=( const Addressee & ) const; | 98 | bool operator!=( const Addressee & ) const; |
99 | // sync stuff | 99 | // sync stuff |
100 | void setTempSyncStat(int id); | 100 | void setTempSyncStat(int id); |
101 | int tempSyncStat() const; | 101 | int tempSyncStat() const; |
102 | void setIDStr( const QString & ); | 102 | void setIDStr( const QString & ); |
103 | QString IDStr() const; | 103 | QString IDStr() const; |
104 | void setID( const QString &, const QString & ); | 104 | void setID( const QString &, const QString & ); |
105 | QString getID( const QString & ); | 105 | QString getID( const QString & ); |
106 | void setCsum( const QString &, const QString & ); | 106 | void setCsum( const QString &, const QString & ); |
107 | QString getCsum( const QString & ); | 107 | QString getCsum( const QString & ); |
108 | void removeID(const QString &); | 108 | void removeID(const QString &); |
109 | void computeCsum(const QString &dev); | ||
110 | ulong getCsum4List( const QStringList & attList); | ||
109 | /** | 111 | /** |
110 | Return, if the address book entry is empty. | 112 | Return, if the address book entry is empty. |
111 | */ | 113 | */ |
112 | bool isEmpty() const; | 114 | bool isEmpty() const; |
113 | 115 | ||
114 | /** | 116 | /** |
115 | Set unique identifier. | 117 | Set unique identifier. |
116 | */ | 118 | */ |
117 | void setUid( const QString &uid ); | 119 | void setUid( const QString &uid ); |
118 | /** | 120 | /** |
119 | Return unique identifier. | 121 | Return unique identifier. |
120 | */ | 122 | */ |
121 | QString uid() const; | 123 | QString uid() const; |
122 | /** | 124 | /** |
123 | Return translated label for uid field. | 125 | Return translated label for uid field. |
124 | */ | 126 | */ |
125 | static QString uidLabel(); | 127 | static QString uidLabel(); |
126 | 128 | ||
127 | /** | 129 | /** |
128 | Set name. | 130 | Set name. |
129 | */ | 131 | */ |
130 | void setName( const QString &name ); | 132 | void setName( const QString &name ); |
131 | /** | 133 | /** |
132 | Return name. | 134 | Return name. |
133 | */ | 135 | */ |
134 | QString name() const; | 136 | QString name() const; |
135 | /** | 137 | /** |
136 | Return translated label for name field. | 138 | Return translated label for name field. |
137 | */ | 139 | */ |
138 | static QString nameLabel(); | 140 | static QString nameLabel(); |
139 | 141 | ||
140 | /** | 142 | /** |
141 | Set formatted name. | 143 | Set formatted name. |
142 | */ | 144 | */ |
143 | void setFormattedName( const QString &formattedName ); | 145 | void setFormattedName( const QString &formattedName ); |
144 | /** | 146 | /** |
145 | Return formatted name. | 147 | Return formatted name. |
146 | */ | 148 | */ |
147 | QString formattedName() const; | 149 | QString formattedName() const; |
148 | /** | 150 | /** |
149 | Return translated label for formattedName field. | 151 | Return translated label for formattedName field. |
150 | */ | 152 | */ |
151 | static QString formattedNameLabel(); | 153 | static QString formattedNameLabel(); |
152 | 154 | ||
153 | /** | 155 | /** |
154 | Set family name. | 156 | Set family name. |
155 | */ | 157 | */ |
156 | void setFamilyName( const QString &familyName ); | 158 | void setFamilyName( const QString &familyName ); |