00001 /* 00002 * Funambol is a mobile platform developed by Funambol, Inc. 00003 * Copyright (C) 2003 - 2007 Funambol, Inc. 00004 * 00005 * This program is free software; you can redistribute it and/or modify it under 00006 * the terms of the GNU Affero General Public License version 3 as published by 00007 * the Free Software Foundation with the addition of the following permission 00008 * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED 00009 * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE 00010 * WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS. 00011 * 00012 * This program is distributed in the hope that it will be useful, but WITHOUT 00013 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 00014 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 00015 * details. 00016 * 00017 * You should have received a copy of the GNU Affero General Public License 00018 * along with this program; if not, see http://www.gnu.org/licenses or write to 00019 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 00020 * MA 02110-1301 USA. 00021 * 00022 * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite 00023 * 305, Redwood City, CA 94063, USA, or at email address info@funambol.com. 00024 * 00025 * The interactive user interfaces in modified source and object code versions 00026 * of this program must display Appropriate Legal Notices, as required under 00027 * Section 5 of the GNU Affero General Public License version 3. 00028 * 00029 * In accordance with Section 7(b) of the GNU Affero General Public License 00030 * version 3, these Appropriate Legal Notices must retain the display of the 00031 * "Powered by Funambol" logo. If the display of the logo is not reasonably 00032 * feasible for technical reasons, the Appropriate Legal Notices must display 00033 * the words "Powered by Funambol". 00034 */ 00035 00036 00037 // 00038 // @author Stefano Fornari @ Funambol 00039 // @version $Id: PersonalDetail.h,v 1.8 2008-04-11 08:17:13 marco_garatti Exp $ 00040 // 00041 00042 00043 #ifndef INCL_PIM_PERSONAL_DETAIL 00044 #define INCL_PIM_PERSONAL_DETAIL 00045 /** @cond DEV */ 00046 00047 #include "vocl/vCard/Address.h" 00048 #include "vocl/vCard/ContactDetail.h" 00049 #include "vocl/vCard/vCardProperty.h" 00050 #include "base/globalsdef.h" 00051 00052 BEGIN_NAMESPACE 00053 00054 /** 00055 * An object containing the personal details of a contact 00056 * 00057 */ 00058 class PersonalDetail { 00059 00060 // ------------------------------------------------------------ Private data 00061 00062 private: 00063 Address* address ; 00064 Address* otherAddress ; 00065 ContactDetail* contactDetail; 00066 vCardProperty* photo ; 00067 WCHAR* spouse ; 00068 WCHAR* children ; 00069 WCHAR* anniversary ; 00070 WCHAR* birthday ; 00071 WCHAR* gender ; 00072 00073 /** 00074 * Sets internal members releasing the currently allocated memory (if 00075 * any was allocate). The passed value is doplicated so that the caller 00076 * can independently release it. 00077 * 00078 * @param property the address of the pointer to set to the new 00079 * allocated memory 00080 * @param v the value to set into the property 00081 */ 00082 void set(WCHAR** p, WCHAR* v); 00083 00084 // -------------------------------------------- Constructors and Destructors 00085 public: 00086 /** 00087 * Creates an empty list of personal details 00088 */ 00089 PersonalDetail(); 00090 ~PersonalDetail(); 00091 00092 // ---------------------------------------------------------- Public methods 00093 00094 /** 00095 * Returns the contact details for this Personal Detail 00096 * 00097 * @return the contact details for this Personal Detail 00098 */ 00099 ContactDetail* getContactDetail(); 00100 00101 /** 00102 * Sets the contact detail. The given ContactDetail is cloned, so that the 00103 * caller can independently release it as needed. 00104 */ 00105 void setContactDetail(ContactDetail& d); 00106 00107 /** 00108 * Returns the address for this Personal Detail 00109 * 00110 * @return the address for this Personal Detail 00111 */ 00112 Address* getAddress(); 00113 00114 /** 00115 * Sets the address. The given Address is cloned, so that the 00116 * caller can independently release it as needed. 00117 */ 00118 void setAddress(Address& a); 00119 00120 /** 00121 * Returns the other address for this Personal Detail 00122 * 00123 * @return the other address for this Personal Detail 00124 */ 00125 Address* getOtherAddress(); 00126 00127 /** 00128 * Sets the other address. The given Address is cloned, so that the 00129 * caller can independently release it as needed. 00130 */ 00131 void setOtherAddress(Address& p); 00132 00133 /** 00134 * Returns the spouse for this Personal Detail 00135 * 00136 * @param buf if not NULL, the value is copied in this buffer 00137 * @param size buffer size 00138 * 00139 * @return the spouse for this Personal Detail 00140 */ 00141 WCHAR* getSpouse(WCHAR* buf = NULL, int size = -1); 00142 00143 /** 00144 * Returns the children for this Personal Detail 00145 * 00146 * @param buf if not NULL, the value is copied in this buffer 00147 * @param size buffer size 00148 * 00149 * @return the children for this Personal Detail 00150 */ 00151 WCHAR* getChildren(WCHAR* buf = NULL, int size = -1); 00152 00153 /** 00154 * Returns the anniversary for this Personal Detail 00155 * 00156 * @param buf if not NULL, the value is copied in this buffer 00157 * @param size buffer size 00158 * 00159 * @return the anniversary for this Personal Detail 00160 */ 00161 WCHAR* getAnniversary(WCHAR* buf = NULL, int size = -1); 00162 00163 /** 00164 * Returns the birthday for this Personal Detail 00165 * 00166 * @param buf if not NULL, the value is copied in this buffer 00167 * @param size buffer size 00168 * 00169 * @return the birthday for this Personal Detail 00170 */ 00171 WCHAR* getBirthday(WCHAR* buf = NULL, int size = -1); 00172 00173 /** 00174 * Returns the gender for this Personal Detail 00175 * 00176 * @param buf if not NULL, the value is copied in this buffer 00177 * @param size buffer size 00178 * 00179 * @return the gender for this Personal Detail 00180 */ 00181 WCHAR* getGender(WCHAR* buf = NULL, int size = -1); 00182 00183 /** 00184 * Returns the photo for this Personal Detail 00185 * 00186 * @return the photo for this Personal Detail 00187 */ 00188 vCardProperty* getPhoto(); 00189 00190 /** 00191 * Sets the photo. The given Property is cloned, so that the 00192 * caller can independently release it as needed. 00193 */ 00194 void setPhoto(vCardProperty& p); 00195 00196 /** 00197 * Sets the spouse for this Personal Detail 00198 * 00199 * @param spouse the spouse to set 00200 */ 00201 void setSpouse (WCHAR* spouse); 00202 00203 /** 00204 * Sets the children for this Personal Detail 00205 * 00206 * @param children the children to set 00207 */ 00208 void setChildren (WCHAR* children); 00209 00210 /** 00211 * Sets the anniversary for this Personal Detail 00212 * 00213 * @param anniversary the anniversary to set 00214 */ 00215 void setAnniversary (WCHAR* anniversary); 00216 00217 /** 00218 * Sets the birthday for this Personal Detail 00219 * 00220 * @param birthday the spouse to set 00221 */ 00222 void setBirthday (WCHAR* birthday); 00223 00224 /** 00225 * Sets the gender for this Personal Detail 00226 * 00227 * @param gender the gender to set 00228 */ 00229 void setGender (WCHAR* gender); 00230 00231 /** 00232 * Creates and returns a new PeronalDetail object. The object is created with 00233 * the C++ new operator and must be deallocated with the delete C++ 00234 * operator 00235 */ 00236 PersonalDetail* clone(); 00237 }; 00238 00239 00240 END_NAMESPACE 00241 00242 /** @endcond */ 00243 #endif