-rw-r--r-- | kabc/phonenumber.h | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/kabc/phonenumber.h b/kabc/phonenumber.h index 2d4d3e0..b9d6a17 100644 --- a/kabc/phonenumber.h +++ b/kabc/phonenumber.h | |||
@@ -19,151 +19,152 @@ | |||
19 | */ | 19 | */ |
20 | 20 | ||
21 | /* | 21 | /* |
22 | Enhanced Version of the file for platform independent KDE tools. | 22 | Enhanced Version of the file for platform independent KDE tools. |
23 | Copyright (c) 2004 Ulf Schenk | 23 | Copyright (c) 2004 Ulf Schenk |
24 | 24 | ||
25 | $Id$ | 25 | $Id$ |
26 | */ | 26 | */ |
27 | 27 | ||
28 | #ifndef KABC_PHONENUMBER_H | 28 | #ifndef KABC_PHONENUMBER_H |
29 | #define KABC_PHONENUMBER_H | 29 | #define KABC_PHONENUMBER_H |
30 | 30 | ||
31 | #include <qvaluelist.h> | 31 | #include <qvaluelist.h> |
32 | #include <qstring.h> | 32 | #include <qstring.h> |
33 | 33 | ||
34 | namespace KABC { | 34 | namespace KABC { |
35 | 35 | ||
36 | /** | 36 | /** |
37 | @short Phonenumber information. | 37 | @short Phonenumber information. |
38 | 38 | ||
39 | This class provides phone number information. A phone number is classified by | 39 | This class provides phone number information. A phone number is classified by |
40 | a type. The following types are available, it's possible to use multiple types | 40 | a type. The following types are available, it's possible to use multiple types |
41 | @ref Types for a number by combining them through a logical or. | 41 | @ref Types for a number by combining them through a logical or. |
42 | */ | 42 | */ |
43 | class PhoneNumber | 43 | class PhoneNumber |
44 | { | 44 | { |
45 | friend QDataStream &operator<<( QDataStream &, const PhoneNumber & ); | 45 | friend QDataStream &operator<<( QDataStream &, const PhoneNumber & ); |
46 | friend QDataStream &operator>>( QDataStream &, PhoneNumber & ); | 46 | friend QDataStream &operator>>( QDataStream &, PhoneNumber & ); |
47 | 47 | ||
48 | public: | 48 | public: |
49 | typedef QValueList<PhoneNumber> List; | 49 | typedef QValueList<PhoneNumber> List; |
50 | typedef QValueList<int> TypeList; | 50 | typedef QValueList<int> TypeList; |
51 | 51 | ||
52 | /** | 52 | /** |
53 | @li @p Home - Home number | 53 | @li @p Home - Home number |
54 | @li @p Work - Office number | 54 | @li @p Work - Office number |
55 | @li @p Msg - Messaging | 55 | @li @p Msg - Messaging |
56 | @li @p Pref - Preferred number | 56 | @li @p Pref - Preferred number |
57 | @li @p Voice - Voice | 57 | @li @p Voice - Voice |
58 | @li @p Fax - Fax machine | 58 | @li @p Fax - Fax machine |
59 | @li @p Cell - Cell phone | 59 | @li @p Cell - Cell phone |
60 | @li @p Video - Video phone | 60 | @li @p Video - Video phone |
61 | @li @p Bbs - Mailbox | 61 | @li @p Bbs - Mailbox |
62 | @li @p Modem - Modem | 62 | @li @p Modem - Modem |
63 | @li @p Car - Car phone | 63 | @li @p Car - Car phone |
64 | @li @p Isdn - ISDN connection | 64 | @li @p Isdn - ISDN connection |
65 | @li @p Pcs - Personal Communication Service | 65 | @li @p Pcs - Personal Communication Service |
66 | @li @p Pager - Pager | 66 | @li @p Pager - Pager |
67 | @li @p SIP - VoIP | ||
68 | */ | 67 | */ |
69 | enum Types { Home = 1, Work = 2, Msg = 4, Pref = 8, Voice = 16, Fax = 32, | 68 | enum Types { Home = 1, Work = 2, Msg = 4, Pref = 8, Voice = 16, Fax = 32, |
70 | Cell = 64, Video = 128, Bbs = 256, Modem = 512, Car = 1024, | 69 | Cell = 64, Video = 128, Bbs = 256, Modem = 512, Car = 1024, |
71 | Isdn = 2048, Pcs = 4096, Pager = 8192, Sip = 16384 }; | 70 | Isdn = 2048, Pcs = 4096, Pager = 8192 }; |
72 | 71 | ||
73 | /** | 72 | /** |
74 | Create an empty phone number object. | 73 | Create an empty phone number object. |
75 | */ | 74 | */ |
76 | PhoneNumber(); | 75 | PhoneNumber(); |
77 | 76 | ||
78 | /** | 77 | /** |
79 | Create a phonenumber object. | 78 | Create a phonenumber object. |
80 | 79 | ||
81 | @param number Number | 80 | @param number Number |
82 | @param type Type as defined in enum. Multiple types can be | 81 | @param type Type as defined in enum. Multiple types can be |
83 | specified by combining them by a logical or. | 82 | specified by combining them by a logical or. |
84 | */ | 83 | */ |
85 | PhoneNumber( const QString &number, int type = Home ); | 84 | PhoneNumber( const QString &number, int type = Home ); |
86 | 85 | ||
87 | /** | 86 | /** |
88 | Destructor. | 87 | Destructor. |
89 | */ | 88 | */ |
90 | ~PhoneNumber(); | 89 | ~PhoneNumber(); |
91 | 90 | ||
92 | bool operator==( const PhoneNumber & ) const; | 91 | bool operator==( const PhoneNumber & ) const; |
93 | bool operator!=( const PhoneNumber & ) const; | 92 | bool operator!=( const PhoneNumber & ) const; |
94 | 93 | ||
95 | bool contains( const PhoneNumber &p ); | 94 | bool contains( const PhoneNumber &p ); |
96 | /** | 95 | /** |
97 | Sets the unique identifier. | 96 | Sets the unique identifier. |
98 | */ | 97 | */ |
99 | void setId( const QString &id ); | 98 | void setId( const QString &id ); |
100 | 99 | ||
101 | /** | 100 | /** |
102 | Returns the unique identifier. | 101 | Returns the unique identifier. |
103 | */ | 102 | */ |
104 | QString id() const; | 103 | QString id() const; |
105 | 104 | ||
106 | /** | 105 | /** |
107 | Sets the number. | 106 | Sets the number. |
108 | */ | 107 | */ |
109 | void setNumber( const QString & ); | 108 | void setNumber( const QString & ); |
110 | 109 | ||
111 | /** | 110 | /** |
112 | Returns the number. | 111 | Returns the number. |
113 | */ | 112 | */ |
114 | QString number() const; | 113 | QString number() const; |
115 | 114 | ||
116 | /** | 115 | /** |
117 | Sets the type. Multiple types can be specified by combining them by | 116 | Sets the type. Multiple types can be specified by combining them by |
118 | a logical or. | 117 | a logical or. |
119 | */ | 118 | */ |
120 | void setType( int ); | 119 | void setType( int ); |
121 | 120 | ||
122 | /** | 121 | /** |
123 | Returns the type. Can be a multiple types combined by a logical or. | 122 | Returns the type. Can be a multiple types combined by a logical or. |
124 | */ | 123 | */ |
125 | int type() const; | 124 | int type() const; |
126 | 125 | ||
127 | /** | 126 | /** |
128 | Returns a translated string of all types the address has. | 127 | Returns a translated string of all types the address has. |
129 | */ | 128 | */ |
130 | QString typeLabel() const; | 129 | QString typeLabel() const; |
131 | 130 | ||
132 | /** | 131 | /** |
133 | Returns the translated label for phone number depending on its type. | 132 | Returns the translated label for phone number depending on its type. |
134 | */ | 133 | */ |
135 | QString label() const; | 134 | QString label() const; |
136 | 135 | ||
137 | /** | 136 | /** |
138 | Returns a list of all available types | 137 | Returns a list of all available types |
139 | */ | 138 | */ |
140 | static TypeList typeList(); | 139 | static TypeList typeList(); |
141 | 140 | ||
142 | /** | 141 | /** |
143 | Returns the translated label for phone number type. | 142 | Returns the translated label for phone number type. |
144 | */ | 143 | */ |
145 | static QString typeLabel( int type ); | 144 | static QString typeLabel( int type ); |
146 | 145 | ||
147 | /** | 146 | /** |
148 | Returns the translated label for phone number type. | 147 | Returns the translated label for phone number type. |
149 | @obsolete | 148 | @obsolete |
150 | */ | 149 | */ |
151 | static QString label( int type ); | 150 | static QString label( int type ); |
152 | bool simplifyNumber(); | 151 | bool simplifyNumber(); |
153 | void simplifyType(); | 152 | void simplifyType(); |
153 | void makeCompat(); | ||
154 | int getCompatType( int type ); | ||
154 | 155 | ||
155 | private: | 156 | private: |
156 | void init(); | 157 | void init(); |
157 | 158 | ||
158 | QString mId; | 159 | QString mId; |
159 | 160 | ||
160 | int mType; | 161 | int mType; |
161 | QString mNumber; | 162 | QString mNumber; |
162 | }; | 163 | }; |
163 | 164 | ||
164 | QDataStream &operator<<( QDataStream &, const PhoneNumber & ); | 165 | QDataStream &operator<<( QDataStream &, const PhoneNumber & ); |
165 | QDataStream &operator>>( QDataStream &, PhoneNumber & ); | 166 | QDataStream &operator>>( QDataStream &, PhoneNumber & ); |
166 | 167 | ||
167 | } | 168 | } |
168 | 169 | ||
169 | #endif | 170 | #endif |