2 // Open Service Platform
3 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
5 // Licensed under the Apache License, Version 2.0 (the License);
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
9 // http://www.apache.org/licenses/LICENSE-2.0
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
18 * @file FSclEmailContact.h
19 * @brief This is the header file for the %EmailContact class.
21 * This header file contains the declarations of the %EmailContact class.
23 #ifndef _FSCL_EMAIL_CONTACT_H_
24 #define _FSCL_EMAIL_CONTACT_H_
26 #include <FBaseResult.h>
27 #include <FBaseObject.h>
28 #include <FBaseString.h>
29 #include <FSclTypes.h>
30 #include <FSclEmail.h>
32 namespace Tizen { namespace Social
36 * @brief This class provides summarized contact information with email.
40 * @final This class is not intended for extension.
42 * The %EmailContact class provides summarized contact information. @n
43 * This provides part of contact information - ID, person ID, addressbook ID, display name, ringtone, thumbnail, and email.
45 class _OSP_EXPORT_ EmailContact
46 : public Tizen::Base::Object
51 * This is the default constructor for this class.
58 * Copying of objects using this copy constructor is allowed.
62 * @param[in] rhs An instance of %EmailContact
64 EmailContact(const EmailContact& rhs);
67 * This destructor overrides Tizen::Base::Object::~Object().
71 virtual ~EmailContact(void);
74 * Checks whether the value of the specified instance is equal to the value of the current instance of Tizen::Base::Object.
78 * @return @c true if the value of the specified instance of Tizen::Base::Object is equal to the value of the current instance of %Tizen::Base::Object, @n
80 * @param[in] rhs An instance of Tizen::Base::Object to compare
82 virtual bool Equals(const Tizen::Base::Object& rhs) const;
85 * Gets the hash value of the current instance.
89 * @return The hash value of the current instance
91 virtual int GetHashCode(void) const;
94 * Gets the addressbook ID.
98 * @return The addressbook ID
100 AddressbookId GetAddressbookId(void) const;
103 * Gets the person ID.
107 * @return The person ID
109 PersonId GetPersonId(void) const;
112 * Gets the contact ID.
116 * @return The contact ID
118 RecordId GetContactId(void) const;
121 * Gets the display name.
125 * @return The display name
127 Tizen::Base::String GetDisplayName(void) const;
130 * Gets the ringtone path.
134 * @return The ringtone path, @n
135 * else an empty string if the ringtone path has not been set for this contact
137 Tizen::Base::String GetRingtonePath(void) const;
140 * Gets the thumbnail path.
144 * @return The thumbnail path, @n
145 * else an empty string if the thumbnail path has not been set for this contact
147 Tizen::Base::String GetThumbnailPath(void) const;
154 * @return An Email instance
156 Email GetEmail(void) const;
159 * Copying of objects using this copy assignment operator is allowed.
163 * @param[in] rhs An instance of %EmailContact
165 EmailContact& operator =(const EmailContact& rhs);
168 friend class _EmailContactImpl;
169 class _EmailContactImpl* __pEmailContactImpl;
175 #endif // _FSCL_EMAIL_CONTACT_H_