// limitations under the License.
//
/**
- * @file FMessaging.h
+ * @file FMessaging.h
* @brief This is the header file for the %Messaging namespace.
*
* This header file contains the declarations and descriptions of the %Messaging namespace.
* @brief This namespace contains classes and interfaces for messaging services.
* @since 2.0
*
- * @remarks @b Header @b %file : @b \#include @b <FMessaging.h> @n
- * @b Library : @b osp-messaging
+ * @remarks @b Header @b %file: @b \#include @b <FMessaging.h> @n
+ * @b Library: @b osp-messaging
*
* The %Messaging namespace accesses the messaging capabilities of the device. @n
* It provides classes and interfaces for the following: @n
// limitations under the License.
//
/**
-* @file FMsgCbsChannel.h
-* @brief This is the header file for the %CbsChannel class.
-*
-* This header file contains the declarations of the %CbsChannel class.
-*/
+ * @file FMsgCbsChannel.h
+ * @brief This is the header file for the %CbsChannel class.
+ *
+ * This header file contains the declarations of the %CbsChannel class.
+ */
#ifndef _FMSG_CBS_CHANNEL_H_
#define _FMSG_CBS_CHANNEL_H_
class _CbsChannelImpl;
/**
-* @class CbsChannel
-* @brief This class provides methods for handling a Cell Broadcast Service (CBS) channel.
-*
-* @since 2.0
-*
-* @final This class is not intended for extension.
-*
-* The %CbsChannel class provides methods for handling a CBS channel. @n
-* It allows you to get and set the CBS channel information.
-*/
+ * @class CbsChannel
+ * @brief This class provides methods for handling a Cell Broadcast Service (CBS) channel.
+ *
+ * @since 2.0
+ *
+ * @final This class is not intended for extension.
+ *
+ * The %CbsChannel class provides methods for handling a CBS channel. It allows the user to get and set the CBS channel information.
+ */
class _OSP_EXPORT_ CbsChannel
: public Tizen::Base::Object
{
public:
- /**
+ /**
* This destructor overrides Tizen::Base::Object::~Object().
*
* @since 2.0
*/
virtual ~CbsChannel(void);
- /**
+ /**
* Gets the range of a CBS channel.
*
* @since 2.0
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The range has not been set as yet.
* @exception E_SYSTEM A system error has occurred.
- * @remarks In case of an error, this method sets the negative values for @c from and @c to. For example, @c -1.
+ * @remarks In case of an error, this method sets negative values for @c from and @c to. For example, @c -1.
*/
result GetRange(int& from, int& to) const;
- /**
+ /**
* Gets the name of a CBS channel.
*
* @since 2.0
*
* @return The name of the channel @n
- * The name can be an empty string.
+ * The name can be an empty string.
*/
Tizen::Base::String GetName(void) const;
- /**
+ /**
* Checks whether a CBS channel is activated.
*
* @since 2.0
*
- * @return @c true if a CBS channel is activated, @n
+ * @return @c true if the CBS channel is activated, @n
* else @c false
*/
bool IsActivated(void) const;
- /**
+ /**
* Activates the status of a CBS channel.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS The application does not have the permission to activate the CBS channel status.
+ * @exception E_ILLEGAL_ACCESS The application does not have the permission to activate the CBS channel's status.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
result Activate(void);
- /**
+ /**
* Deactivates the status of a CBS channel.
*
* @since 2.0
*
* @return An error code
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS The application does not have the permission to activate the CBS channel status.
+ * @exception E_ILLEGAL_ACCESS The application does not have the permission to activate the CBS channel's status.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
result Deactivate(void);
- /**
+ /**
* Updates the name of a CBS channel.
*
* @since 2.0
* @return An error code
* @param[in] name The name of the CBS channel to update
* @exception E_SUCCESS The method is successful.
- * @exception E_ILLEGAL_ACCESS The application does not have the permission to update the CBS channel name.
+ * @exception E_ILLEGAL_ACCESS The application does not have the permission to update the CBS channel's name.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
*/
* @param[in] to The last index of the message ID of the channel
* @param[in] name The name of the channel (can be an empty string)
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c to parameter is smaller than @c from. @n
- * - The specified @c to or @c from parameter is a negative value. @n
- * - The specified @c to parameter exceeds the limit (0xFFFF). @n
- * - The range (@c to - @c from) exceeds the limit (0xFFFF). @n
- * - The specified @c name string length is greater than @c 32. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c to parameter is smaller than @c from.
+ * - The specified @c to or @c from parameter is a negative value.
+ * - The specified @c to parameter exceeds the limit (0xFFFF).
+ * - The range (@c to - @c from) exceeds the limit (0xFFFF).
+ * - The specified @c name string length is greater than @c 32.
* @exception E_SYSTEM A system error has occurred.
*/
result Construct(int from, int to, const Tizen::Base::String& name);
-//\r
-// Open Service Platform\r
-// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.\r
-//\r
-// Licensed under the Apache License, Version 2.0 (the License);\r
-// you may not use this file except in compliance with the License.\r
-// You may obtain a copy of the License at\r
-//\r
-// http://www.apache.org/licenses/LICENSE-2.0\r
-//\r
-// Unless required by applicable law or agreed to in writing, software\r
-// distributed under the License is distributed on an "AS IS" BASIS,\r
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
-// See the License for the specific language governing permissions and\r
-// limitations under the License.\r
-//\r
-/**\r
-* @file FMsgCbsMessage.h\r
-* @brief This is the header file for the %CbsMessage class.\r
-*\r
-* This header file contains the declarations of the %CbsMessage class.\r
-*/\r
-\r
-#ifndef _FMSG_CBS_MESSAGE_H_\r
-#define _FMSG_CBS_MESSAGE_H_\r
-\r
-namespace Tizen { namespace Base\r
-{\r
-class ByteBuffer;\r
-class String;\r
-class DateTime;\r
-} }\r
-\r
-#include <FBaseObject.h>\r
-#include <FMsgTypes.h>\r
-\r
-namespace Tizen { namespace Messaging\r
-{\r
-\r
-class _CbsMessageImpl;\r
-\r
-/**\r
-* @class CbsMessage\r
-*\r
-* @brief This class provides methods for handling a CBS message.\r
-*\r
-* @since 2.0\r
-*\r
-* @final This class is not intended for extension.\r
-*\r
-* The %CbsMessage class provides methods for handling a CBS message (including the ETWS secondary notification). It allows you to get the serial number,\r
-* message ID, body text, and received time of a CBS message.\r
-*/\r
-class _OSP_EXPORT_ CbsMessage\r
- : public Tizen::Base::Object\r
-{\r
-public:\r
- /**\r
- * This destructor overrides Tizen::Base::Object::~Object().\r
- *\r
- * @since 2.0\r
- */\r
- virtual ~CbsMessage(void);\r
-\r
- /**\r
- * Compares the calling instance with the specified instance.\r
- *\r
- * @since 2.0\r
- *\r
- * @return @c true if the specified instance of Tizen::Base::Object is equal to the calling %CbsMessage instance, @n\r
- * else @c false\r
- * @param[in] obj An instance of Tizen::Base::Object to compare\r
- * @see Tizen::Base::Object::Equals()\r
- */\r
- virtual bool Equals(const Tizen::Base::Object& obj) const;\r
-\r
- /**\r
- * Copies the instance of a class.\r
- *\r
- * @since 2.0\r
- *\r
- * @return An instance of %CbsMessage @n\r
- * The value is @c null in case of an error.\r
- * @exception E_SUCCESS The method is successful.\r
- * @exception E_OUT_OF_MEMORY The memory is insufficient.\r
- *\r
- * @remarks The specific error code can be accessed using the GetLastResult() method.\r
- */\r
- CbsMessage* CloneN(void) const;\r
-\r
- /**\r
- * Gets the hash value of the current instance.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The hash value of the current instance\r
- */\r
- virtual int GetHashCode(void) const;\r
-\r
- /**\r
- * Checks whether this message is an ETWS notification.\r
- *\r
- * @since 2.0\r
- *\r
- * @return @c true if this message is an ETWS notification, @n\r
- * else @c false\r
- * @remarks If the return value is @c true, the message is ETWS secondary notification.\r
- */\r
- bool IsEtwsNotification(void) const;\r
-\r
- /**\r
- * Gets the serial number of the CBS message.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The serial number of the CBS message @n\r
- * The value is @c null in case of an error.\r
- * @exception E_SUCCESS The method is successful.\r
- * @exception E_OUT_OF_MEMORY The memory is insufficient.\r
- * @remarks The specific error code can be accessed using the GetLastResult() method.\r
- */\r
- Tizen::Base::ByteBuffer* GetSerialNumberN(void) const;\r
-\r
- /**\r
- * Gets the message ID of the CBS message.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The message ID of the CBS message\r
- */\r
- int GetMessageId(void) const;\r
-\r
- /**\r
- * Gets the body of a message.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The body of a message\r
- */\r
- Tizen::Base::String GetText(void) const;\r
-\r
- /**\r
- * Gets the date and time (UTC time) of the message when it is received.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The date and time (UTC time) when the message is received\r
- */\r
- Tizen::Base::DateTime GetReceivedTime(void) const;\r
-\r
- /**\r
- * Gets the Data Coding Scheme of the CBS message.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The Data Coding Scheme of the CBS message @n\r
- * The value is @c null in case of an error.\r
- * @exception E_SUCCESS The method is successful.\r
- * @exception E_OUT_OF_MEMORY The memory is insufficient.\r
- * @remarks \r
- * - The specific error code can be accessed using the GetLastResult() method.\r
- * - The alphabet/coding and the language applied to CBS messages are defined in 3GPP TS 23.038.\r
- */\r
- byte GetDataCodingScheme(void) const;\r
-\r
- /**\r
- * Gets the language type of a message.\r
- *\r
- * @since 2.1\r
- *\r
- * @return The language type of a message\r
- */\r
- Tizen::Base::String GetLanguageType(void) const;\r
-\r
-private:\r
- /**\r
- * This default constructor is intentionally declared as private so that only the platform can create an instance.\r
- *\r
- * @since 2.0\r
- */\r
- CbsMessage(void);\r
-\r
- /**\r
- * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.\r
- *\r
- * @since 2.0\r
- *\r
- * @param[in] rhs An instance of %CbsMessage\r
- */\r
- CbsMessage(const CbsMessage& rhs);\r
-\r
- /**\r
- * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects. @n\r
- * - Use CloneN() to get an exact copy of the instance.\r
- * - Use Equals() to compare the contents of one instance with the other.\r
- *\r
- * @since 2.0\r
- *\r
- * @return A reference to this instance\r
- * @param[in] rhs An instance of %CbsMessage\r
- */\r
- CbsMessage& operator =(const CbsMessage& rhs);\r
-\r
-private:\r
- _CbsMessageImpl* __pCbsMessageImpl;\r
-\r
- friend class _CbsMessageImpl;\r
-}; // CbsMessage\r
-\r
-} } // Tizen::Messaging\r
-#endif // _FMSG_CBS_MESSAGE_H_\r
+//
+// Open Service Platform
+// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+/**
+ * @file FMsgCbsMessage.h
+ * @brief This is the header file for the %CbsMessage class.
+ *
+ * This header file contains the declarations of the %CbsMessage class.
+ */
+
+#ifndef _FMSG_CBS_MESSAGE_H_
+#define _FMSG_CBS_MESSAGE_H_
+
+namespace Tizen { namespace Base
+{
+class ByteBuffer;
+class String;
+class DateTime;
+} }
+
+#include <FBaseObject.h>
+#include <FMsgTypes.h>
+
+namespace Tizen { namespace Messaging
+{
+
+class _CbsMessageImpl;
+
+/**
+ * @class CbsMessage
+ *
+ * @brief This class provides methods for handling a CBS message.
+ *
+ * @since 2.0
+ *
+ * @final This class is not intended for extension.
+ *
+ * The %CbsMessage class provides methods for handling a CBS message (including a ETWS secondary notification). It allows the user to get the serial number,
+ * message ID, body text, and received time of a CBS message.
+ */
+class _OSP_EXPORT_ CbsMessage
+ : public Tizen::Base::Object
+{
+public:
+ /**
+ * This destructor overrides Tizen::Base::Object::~Object().
+ *
+ * @since 2.0
+ */
+ virtual ~CbsMessage(void);
+
+ /**
+ * Compares the specified instance with the current instance.
+ *
+ * @since 2.0
+ *
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the caurrent %CbsMessage instance, @n
+ * else @c false
+ * @param[in] obj An instance of Tizen::Base::Object to compare
+ * @see Tizen::Base::Object::Equals()
+ */
+ virtual bool Equals(const Tizen::Base::Object& obj) const;
+
+ /**
+ * Copies the instance of this class.
+ *
+ * @since 2.0
+ *
+ * @return An instance of %CbsMessage, @n
+ * else @c null in case of an error
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ *
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ */
+ CbsMessage* CloneN(void) const;
+
+ /**
+ * Gets the hash value of the current instance.
+ *
+ * @since 2.0
+ *
+ * @return The hash value of the current instance
+ */
+ virtual int GetHashCode(void) const;
+
+ /**
+ * Checks whether this message is an ETWS notification.
+ *
+ * @since 2.0
+ *
+ * @return @c true if this message is an ETWS notification, @n
+ * else @c false
+ * @remarks If the return value is @c true, the message is an ETWS secondary notification.
+ */
+ bool IsEtwsNotification(void) const;
+
+ /**
+ * Gets the serial number of a CBS message.
+ *
+ * @since 2.0
+ *
+ * @return The serial number of the CBS message, @n
+ * else @c null in case of an error
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ */
+ Tizen::Base::ByteBuffer* GetSerialNumberN(void) const;
+
+ /**
+ * Gets the message ID of a CBS message.
+ *
+ * @since 2.0
+ *
+ * @return The message ID of the CBS message
+ */
+ int GetMessageId(void) const;
+
+ /**
+ * Gets the body of a message.
+ *
+ * @since 2.0
+ *
+ * @return The body of the message
+ */
+ Tizen::Base::String GetText(void) const;
+
+ /**
+ * Gets the date and time (UTC time) of a message when it is received.
+ *
+ * @since 2.0
+ *
+ * @return The date and time (UTC time) when the message is received
+ */
+ Tizen::Base::DateTime GetReceivedTime(void) const;
+
+ /**
+ * Gets the Data Coding Scheme of a CBS message.
+ *
+ * @since 2.0
+ *
+ * @return The Data Coding Scheme of the CBS message, @n
+ * else @c null in case of an error
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @remarks
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The alphabet/coding and language applied to CBS messages are defined in 3GPP TS 23.038.
+ */
+ byte GetDataCodingScheme(void) const;
+
+ /**
+ * Gets the language type of a message.
+ *
+ * @since 2.1
+ *
+ * @return The language type of the message
+ */
+ Tizen::Base::String GetLanguageType(void) const;
+
+private:
+ /**
+ * This default constructor is intentionally declared as private so that only the platform can create an instance.
+ *
+ * @since 2.0
+ */
+ CbsMessage(void);
+
+ /**
+ * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
+ *
+ * @since 2.0
+ *
+ * @param[in] rhs An instance of %CbsMessage
+ */
+ CbsMessage(const CbsMessage& rhs);
+
+ /**
+ * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects. @n
+ * - Use CloneN() to get an exact copy of the instance.
+ * - Use Equals() to compare the contents of one instance with the other.
+ *
+ * @since 2.0
+ *
+ * @return A reference to this instance
+ * @param[in] rhs An instance of %CbsMessage
+ */
+ CbsMessage& operator =(const CbsMessage& rhs);
+
+private:
+ _CbsMessageImpl* __pCbsMessageImpl;
+
+ friend class _CbsMessageImpl;
+}; // CbsMessage
+
+} } // Tizen::Messaging
+#endif // _FMSG_CBS_MESSAGE_H_
// limitations under the License.
//
/**
-* @file FMsgDetailedEmailMessage.h
-* @brief This is the header file for the %DetailedEmailMessage class.
-*
-* This header file contains the declarations of the %DetailedEmailMessage class.
-*/
+ * @file FMsgDetailedEmailMessage.h
+ * @brief This is the header file for the %DetailedEmailMessage class.
+ *
+ * This header file contains the declarations of the %DetailedEmailMessage class.
+ */
#ifndef _FMSG_DETAILED_EMAIL_MESSAGE_H_
#define _FMSG_DETAILED_EMAIL_MESSAGE_H_
namespace Tizen { namespace Messaging
{
- /**
+ /**
* @enum EmailMessageClass
*
- * Defines the class of the email messages.
+ * Defines the classes of an email message.
*
* @since 2.0
*
*/
enum EmailMessageClass
{
- EMAIL_MESSAGE_CLASS_UNSPECIFIED = 0, /**<Unspecified */
- EMAIL_MESSAGE_CLASS_UNKNOWN, /**<Unknown */
- EMAIL_MESSAGE_CLASS_NOTE, /**<Normal email message */
- EMAIL_MESSAGE_CLASS_NOTE_RULES_OOF_TEMPLATE_MICROSOFT, /**<Out-of-office template */
- EMAIL_MESSAGE_CLASS_NOTE_SMIME, /**<The message is encrypted and can also be signed */
- EMAIL_MESSAGE_CLASS_NOTE_SMIME_MULTIPART_SIGNED, /**<The message is clear signed */
- EMAIL_MESSAGE_CLASS_NOTIFICATION_MEETING, /**<Meeting notification */
- EMAIL_MESSAGE_CLASS_OCTEL_VOICE, /**<Octel voice message */
- EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_REQUEST, /**<Meeting request */
- EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_CANCELLED, /**<Meeting cancelled */
- EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_POSITIVE_RESPONSE, /**<Positive meeting response */
- EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_TENTATIVE_RESPONSE, /**<Tentative meeting response */
- EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_NEGATIVE_RESPONSE, /**<Negative meeting response */
- EMAIL_MESSAGE_CLASS_POST, /**<Post */
- EMAIL_MESSAGE_CLASS_INFO_PATH_FORM, /**<An InfoPath form */
- EMAIL_MESSAGE_CLASS_VOICE_NOTES, /**<Electronic voice notes */
- EMAIL_MESSAGE_CLASS_SHARING, /**<Shared message */
+ EMAIL_MESSAGE_CLASS_UNSPECIFIED = 0, /**< Unspecified */
+ EMAIL_MESSAGE_CLASS_UNKNOWN, /**< Unknown */
+ EMAIL_MESSAGE_CLASS_NOTE, /**< Normal email message */
+ EMAIL_MESSAGE_CLASS_NOTE_RULES_OOF_TEMPLATE_MICROSOFT, /**< Out-of-office template */
+ EMAIL_MESSAGE_CLASS_NOTE_SMIME, /**< The message is encrypted and can also be signed */
+ EMAIL_MESSAGE_CLASS_NOTE_SMIME_MULTIPART_SIGNED, /**< The message is clear signed */
+ EMAIL_MESSAGE_CLASS_NOTIFICATION_MEETING, /**< Meeting notification */
+ EMAIL_MESSAGE_CLASS_OCTEL_VOICE, /**< Octel voice message */
+ EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_REQUEST, /**< Meeting request */
+ EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_CANCELLED, /**< Meeting cancelled */
+ EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_POSITIVE_RESPONSE, /**< Positive meeting response */
+ EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_TENTATIVE_RESPONSE, /**< Tentative meeting response */
+ EMAIL_MESSAGE_CLASS_SCHEDULE_MEETING_NEGATIVE_RESPONSE, /**< Negative meeting response */
+ EMAIL_MESSAGE_CLASS_POST, /**< Post */
+ EMAIL_MESSAGE_CLASS_INFO_PATH_FORM, /**< An InfoPath form */
+ EMAIL_MESSAGE_CLASS_VOICE_NOTES, /**< Electronic voice notes */
+ EMAIL_MESSAGE_CLASS_SHARING, /**< Shared message */
//EMAIL_MESSAGE_CLASS_NOTE_EXCHANGE_ACTIVE_SYNC_REMOTE_WIPE_CONFIRMATION, // should be added
- EMAIL_MESSAGE_CLASS_VOICE_MAIL, /**<Voice mail */
+ EMAIL_MESSAGE_CLASS_VOICE_MAIL, /**< Voice mail */
//EMAIL_MESSAGE_CLASS_SMS,
//EMAIL_MESSAGE_CLASS_SMART_REPLY = 0x01000000,
//EMAIL_MESSAGE_CLASS_SMART_FORWARD = 0x02000000,
- EMAIL_MESSAGE_CLASS_REPORT_NOT_READ_REPORT = 0x10000000, /**<Not read report for a standard message */
- EMAIL_MESSAGE_CLASS_REPORT_READ_REPORT = 0x20000000, /**<Read report for a standard message */
- EMAIL_MESSAGE_CLASS_REPORT_NON_DELIVERY_RECEIPT = 0x40000000, /**<Non-delivery report for a standard message */
- EMAIL_MESSAGE_CLASS_REPORT_DELIVERY_RECEIPT = 0x80000000 /**<Delivery receipt for a standard message */
+ EMAIL_MESSAGE_CLASS_REPORT_NOT_READ_REPORT = 0x10000000, /**< Not read report for a standard message */
+ EMAIL_MESSAGE_CLASS_REPORT_READ_REPORT = 0x20000000, /**< Read report for a standard message */
+ EMAIL_MESSAGE_CLASS_REPORT_NON_DELIVERY_RECEIPT = 0x40000000, /**< Non-delivery receipt for a standard message */
+ EMAIL_MESSAGE_CLASS_REPORT_DELIVERY_RECEIPT = 0x80000000 /**< Delivery receipt for a standard message */
};
- /**
+ /**
* @enum EmailDigestType
*
- * Defines the digest type of the email messages.
+ * Defines the digest types of an email message.
*
* @since 2.0
*/
enum EmailDigestType
{
- EMAIL_DIGEST_TYPE_MD5 = 0, /**<The MD5 type */
- EMAIL_DIGEST_TYPE_SHA1 /**<The SHA-1 type */
+ EMAIL_DIGEST_TYPE_MD5 = 0, /**< The MD5 type */
+ EMAIL_DIGEST_TYPE_SHA1 /**< The SHA-1 type */
};
- /**
+ /**
* @enum EmailSmimeType
*
- * Defines the S/MIME type of the email messages.
+ * Defines the S/MIME types of an email message.
*
* @since 2.0
*/
enum EmailSmimeType
{
- EMAIL_SMIME_TYPE_NONE = 0, /**<The undefined type */
- EMAIL_SMIME_TYPE_SIGNED, /**<The signed type */
- EMAIL_SMIME_TYPE_ENCRYPTED, /**<The encrypted type */
- EMAIL_SMIME_TYPE_SIGNED_AND_ENCRYPTED /**<Both signed and encrypted type */
+ EMAIL_SMIME_TYPE_NONE = 0, /**< The undefined type */
+ EMAIL_SMIME_TYPE_SIGNED, /**< The signed type */
+ EMAIL_SMIME_TYPE_ENCRYPTED, /**< The encrypted type */
+ EMAIL_SMIME_TYPE_SIGNED_AND_ENCRYPTED /**< Both signed and encrypted type */
};
- /**
+ /**
* @enum EmailReturnReceiptType
*
- * Defines the return receipt type for an email message.
+ * Defines the return receipt types for an email message.
*
* @since 2.0
*/
enum EmailReturnReceiptType
{
- EMAIL_RETURN_RECEIPT_TYPE_NONE = 0x00, /**<Normal Mail */
- EMAIL_RETURN_RECEIPT_TYPE_REQUEST = 0x03, /**<MDN-requesting mail*/ // should be deprecated
- EMAIL_RETURN_RECEIPT_TYPE_DSN = 0x04, /**<Delivery Status Notification (DSN - Delivery Status Mail)*/
- EMAIL_RETURN_RECEIPT_TYPE_MDN = 0x08, /**<Message Disposition Notification (MDN - Read Status Mail)*/
+ EMAIL_RETURN_RECEIPT_TYPE_NONE = 0x00, /**< Normal Mail */
+ EMAIL_RETURN_RECEIPT_TYPE_REQUEST = 0x03, /**< MDN-requesting mail */ // should be deprecated
+ EMAIL_RETURN_RECEIPT_TYPE_DSN = 0x04, /**< Delivery Status Notification (DSN - Delivery Status Mail) */
+ EMAIL_RETURN_RECEIPT_TYPE_MDN = 0x08, /**< Message Disposition Notification (MDN - Read Status Mail) */
//EMAIL_RETURN_RECEIPT_TYPE_REQUEST_DSN = 0x10,
//EMAIL_RETURN_RECEIPT_TYPE_REQUEST_MDN = 0x20,
};
- /**
+ /**
* @enum EmailMessageBodyType
*
- * Defines the type of an email message body.
+ * Defines the types of an email message body.
*
* @since 2.0
*/
enum EmailMessageBodyType
{
- EMAIL_MESSAGE_BODY_TYPE_PLAIN_TEXT = 0, /**<The plain text type */
- EMAIL_MESSAGE_BODY_TYPE_HTML, /**<The HTML type */
- EMAIL_MESSAGE_BODY_TYPE_MIME /**<The MIME type */
+ EMAIL_MESSAGE_BODY_TYPE_PLAIN_TEXT = 0, /**< The plain text type */
+ EMAIL_MESSAGE_BODY_TYPE_HTML, /**< The HTML type */
+ EMAIL_MESSAGE_BODY_TYPE_MIME /**< The MIME type */
};
// forward declaration
class _DetailedEmailMessageImpl;
- /**
+ /**
* @class DetailedEmailMessage
* @brief This class provides methods for handling detailed email messages.
*
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
DetailedEmailMessage(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
*/
virtual ~DetailedEmailMessage(void);
- /**
+ /**
* This is the copy constructor for the %DetailedEmailMessage class. @n
* Copying of objects using this copy constructor is allowed.
*
* @since 2.0
*
- * @param[in] rhs An instance of %DetailedEmailMessage
+ * @param[in] rhs An instance of %DetailedEmailMessage to copy
*/
DetailedEmailMessage(const DetailedEmailMessage& rhs);
public:
- /**
+ /**
* Assigns the value of the specified instance to the current instance of %DetailedEmailMessage. @n
* Copying of objects using this copy assignment operator is allowed.
*
* @since 2.0
*
- * @return The reference of this instance
- * @param[in] rhs An instance of %DetailedEmailMessage
+ * @return A reference of this instance
+ * @param[in] rhs An instance of %DetailedEmailMessage to copy
*/
DetailedEmailMessage& operator =(const DetailedEmailMessage& rhs);
- /**
- * Compares the calling instance with the specified instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if the specified instance of Tizen::Base::Object is equal to the calling %DetailedEmailMessage instance, @n
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %DetailedEmailMessage instance, @n
* else @c false
* @param[in] obj An instance of Tizen::Base::Object to compare
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
///////////////////////////////////////////////////////////////
// Getters
///////////////////////////////////////////////////////////////
- /**
+ /**
* Gets the message ID.
*
* @since 2.0
*/
Tizen::Base::String GetMessageId(void) const;
- /**
+ /**
* Gets the subject of an email message.
*
* @since 2.0
*
- * @return The subject of an email message
+ * @return The subject of the email message
* @see SetSubject()
*/
Tizen::Base::String GetSubject(void) const;
- /**
+ /**
* Gets the time when an email message is created.
*
* @since 2.0
*
- * @return The time when an email message is created
- * @remarks The creation time may be updated by mail server when an email is sent.
+ * @return The time when the email message is created
+ * @remarks The creation time may be updated by the mail server when an email is sent.
* @see SetCreationTime()
*/
Tizen::Base::DateTime GetCreationTime(void) const;
- /**
- * Gets the email address of the specific recipient type.
+ /**
+ * Gets the email address of the specified recipient type.
*
* @since 2.0
*
- * @return The email address of the specific recipient type @n
- * The values for the various recipients can be a string with multiple email addresses separated by semi-colons(;).
- * @param[in] type The type of recipient @n
- * The value contains @c RECIPIENT_TYPE_TO, @c RECIPIENT_TYPE_CC, @c RECIPIENT_TYPE_BCC
+ * @return The email address of the specified recipient type @n
+ * The values for the various recipients can be a string with multiple email addresses separated by semi-colons(;).
+ * @param[in] type The recipient type @n
+ * This value contains @c RECIPIENT_TYPE_TO, @c RECIPIENT_TYPE_CC or @c RECIPIENT_TYPE_BCC.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c type is invalid.
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @see SetAddress()
*
*/
Tizen::Base::String GetAddress(RecipientType type) const;
- /**
+ /**
* Gets the email address of an author.
*
* @since 2.0
*
- * @return The email address of an author
+ * @return The email address of the author
* @see SetFromAddress()
*/
Tizen::Base::String GetFromAddress(void) const;
- /**
+ /**
* Gets the email address used to reply to a message.
*
* @since 2.0
*
- * @return The email address used to reply to a message
+ * @return The email address used to reply to the message
* @see SetReplyToAddress()
*/
Tizen::Base::String GetReplyToAddress(void) const;
- /**
+ /**
* Gets the return path.
*
* @since 2.0
*/
Tizen::Base::String GetReturnPath(void) const;
- /**
+ /**
* Gets the file path of the specified message body type.
*
* @since 2.0
*
- * @return The file path of the message body
- * @param[in] type The type of message body
+ * @return The file path of the message body type
+ * @param[in] type The message body type
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c type is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::String GetFilePath(EmailMessageBodyType type) const;
- /**
+ /**
* Gets the priority of a message.
*
* @since 2.0
*
- * @return The priority of a message
+ * @return The priority of the message
* @see SetPriority()
*/
EmailMessagePriority GetPriority(void) const;
- /**
+ /**
* Gets the return receipt type of a message.
*
* @since 2.0
*
- * @return The return receipt type of a message
+ * @return The return receipt type of the message
* @see SetReturnReceiptType()
*/
EmailReturnReceiptType GetReturnReceiptType(void) const;
- /**
+ /**
* Gets the inline content count of a message.
*
* @since 2.0
*
- * @return The inline content count of a message
+ * @return The inline content count of the message
* @see SetInlineContentCount()
*/
int GetInlineContentCount(void) const;
- /**
+ /**
* Gets the class of a message.
*
* @since 2.0
*
- * @return The class of a message
+ * @return The class of the message
* @see SetClass()
*/
EmailMessageClass GetClass(void) const;
- /**
+ /**
* Gets the digest type of a message.
*
* @since 2.0
*/
EmailDigestType GetDigestType(void) const;
- /**
+ /**
* Gets the S/MIME type of a message.
*
* @since 2.0
*
- * @return The S/MIME type of a message
+ * @return The S/MIME type of the message
* @see SetSmimeType()
*/
EmailSmimeType GetSmimeType(void) const;
- /**
+ /**
* Gets the attachment list of this message.
*
* @since 2.0
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @remarks
* - The specific error code can be accessed using the GetLastResult() method.
- * - After using the attachment list, you can call Tizen::Base::Collection::IList::RemoveAll(true) to clean up items in the list.
+ * - After using the attachment list, the user can call Tizen::Base::Collection::IList::RemoveAll(true) to clean up items from the list.
* @see EmailAttachment
* @see SetAttachmentList()
*/
///////////////////////////////////////////////////////////////
// Setters
///////////////////////////////////////////////////////////////
- /**
+ /**
* Sets the message ID.
*
* @since 2.0
* @exception E_INVALID_ARG The length of the specified @c messageId is @c 0.
* @remarks
* - The message ID is an automatically generated field.
- * - It is used to prevent multiple delivery and for reference in In-Reply-To.
+ * - It is used to prevent multiple delivery and is used as a reference in In-Reply-To.
* @see GetMessageId()
*/
result SetMessageId(const Tizen::Base::String& messageId);
- /**
+ /**
* Sets the subject of an email message.
*
* @since 2.0
*/
result SetSubject(const Tizen::Base::String& subject);
- /**
+ /**
* Sets the time when an email message is created.
*
* @since 2.0
* @param[in] dateTime The time when the email message is created
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c dateTime is invalid. @n
- * The valid range of the time can be from "January 1 1900 00:00:00" to "December 31 2100 23:59:59".
+ * The valid range of the time can be from "January 1 1900 00:00:00" to "December 31 2100 23:59:59".
* @see GetCreationTime()
*/
result SetCreationTime(const Tizen::Base::DateTime& dateTime);
- /**
- * Sets the recipient list of the specific recipient type.
+ /**
+ * Sets the recipient list of the specified recipient type.
*
* @since 2.0
*
* @return An error code
- * @param[in] type The type of recipient @n
- * The value contains @c RECIPIENT_TYPE_TO, @c RECIPIENT_TYPE_CC, @c RECIPIENT_TYPE_BCC.
+ * @param[in] type The recipient type @n
+ * The value contains @c RECIPIENT_TYPE_TO, @c RECIPIENT_TYPE_CC or @c RECIPIENT_TYPE_BCC.
* @param[in] recipients The recipients string @n
- * The values for the various recipients can be a string with multiple email addresses separated by semi-colons(;).
+ * The values for the various recipients can be a string with multiple email addresses separated by semi-colons(;).
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c type is invalid, or
- * the specified @c recipients string length is too short (< 5).
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c type is invalid.
+ * - The specified @c recipients string length is too short (< 5).
* @see GetAddress()
*/
result SetAddress(RecipientType type, const Tizen::Base::String& recipients);
- /**
+ /**
* Sets the email address of an author.
*
* @since 2.0
*/
result SetFromAddress(const Tizen::Base::String& address);
- /**
+ /**
* Sets the email address used to reply to a message.
*
* @since 2.0
*/
result SetReplyToAddress(const Tizen::Base::String& address);
- /**
+ /**
* Sets the return path.
*
* @since 2.0
*/
result SetReturnPath(const Tizen::Base::String& address);
- /**
+ /**
* Sets the file path of the specified message body type.
*
* @since 2.0
*
* @return An error code
- * @param[in] type The type of message body
+ * @param[in] type The message body type
* @param[in] filePath The file path of the message body
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c type is invalid, or
- * the length of the specified @c filePath is too long or @c 0.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c type is invalid.
+ * - The length of the specified @c filePath is either too long or @c 0.
* @exception E_FILE_NOT_FOUND The specified file cannot be found or accessed.
* @see GetFilePath()
*
*/
result SetFilePath(EmailMessageBodyType type, const Tizen::Base::String& filePath);
- /**
+ /**
* Sets the priority of a message.
*
* @since 2.0
*/
result SetPriority(EmailMessagePriority priority);
- /**
+ /**
* Sets the return receipt type of a message.
*
* @since 2.0
*/
result SetReturnReceiptType(EmailReturnReceiptType type);
- /**
+ /**
* Sets the inline content count of a message.
*
* @since 2.0
*/
result SetInlineContentCount(int count);
- /**
+ /**
* Sets the class of a message.
*
* @since 2.0
*/
result SetClass(EmailMessageClass messageClass);
- /**
+ /**
* Sets the digest type of a message.
*
* @since 2.0
*/
result SetDigestType(EmailDigestType type);
- /**
+ /**
* Sets the S/MIME type of a message.
*
* @since 2.0
*/
result SetSmimeType(EmailSmimeType type);
- /**
+ /**
* Sets the attachment list for this message.
*
* @since 2.0
*
* @return An error code
- * @param[in] pList A list of EmailAttachment
+ * @param[in] pList The list of EmailAttachment
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The list is not made of EmailAttachment.
- * @see EmailAttachment
* @see GetAttachmentListN()
*/
result SetAttachmentList(const Tizen::Base::Collection::IList* pList);
///////////////////////////////////////////////////////////////
// static methods
///////////////////////////////////////////////////////////////
- /**
+ /**
* Parses the MIME file to %DetailedEmailMessage format.
*
* @since 2.0
*/
static result ParseMimeFile(const Tizen::Base::String& filePath, DetailedEmailMessage& message);
- /**
+ /**
* Writes to the MIME file from %DetailedEmailMessage.
*
* @since 2.0
// limitations under the License.
//
/**
-* @file FMsgEmailAttachment.h
-* @brief This is the header file for the %EmailAttachment class.
-*
-* This header file contains the declarations of the %EmailAttachment class.
-*/
+ * @file FMsgEmailAttachment.h
+ * @brief This is the header file for the %EmailAttachment class.
+ *
+ * This header file contains the declarations of the %EmailAttachment class.
+ */
#ifndef _FMSG_EMAIL_ATTACHMENT_H_
#define _FMSG_EMAIL_ATTACHMENT_H_
// forward declaration
class _EmailAttachmentImpl;
- /**
+ /**
* @class EmailAttachment
* @brief This class provides methods for handling email attachments.
*
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
EmailAttachment(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
*/
virtual ~EmailAttachment(void);
- /**
+ /**
* This is the copy constructor for the %EmailAttachment class. @n
* Copying of objects using this copy constructor is allowed.
*
* @since 2.0
*
- * @param[in] rhs An instance of %EmailAttachment
+ * @param[in] rhs An instance of %EmailAttachment to copy
*/
EmailAttachment(const EmailAttachment& rhs);
public:
- /**
+ /**
* Assigns the value of the specified instance to the current instance of %EmailAttachment. @n
* Copying of objects using this copy assignment operator is allowed.
*
* @since 2.0
*
- * @return The reference of this instance
- * @param[in] rhs An instance of %EmailAttachment
+ * @return A reference of this instance
+ * @param[in] rhs An instance of %EmailAttachment to copy
*/
EmailAttachment& operator =(const EmailAttachment& rhs);
- /**
- * Compares the calling instance with the specified instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if the specified instance of Tizen::Base::Object is equal to the calling %EmailAttachment instance, @n
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %EmailAttachment instance, @n
* else @c false
* @param[in] obj An instance of Tizen::Base::Object to compare
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
///////////////////////////////////////////////////////////////
// Getters
///////////////////////////////////////////////////////////////
- /**
+ /**
* Gets the name of an email attachment.
*
* @since 2.0
*
- * @return The name of an email attachment
+ * @return The name of the email attachment
* @see SetName()
*/
Tizen::Base::String GetName(void) const;
- /**
+ /**
* Gets the file path of an email attachment.
*
* @since 2.0
*
- * @return The file path of an email attachment
+ * @return The file path of the email attachment
* @see SetFilePath()
*/
Tizen::Base::String GetFilePath(void) const;
- /**
+ /**
* Gets the size of an email attachment.
*
* @since 2.0
*
- * @return The size of an email attachment
+ * @return The size of the email attachment
*/
int GetSize(void) const;
- /**
+ /**
* Gets the inline-content status of an email attachment.
*
* @since 2.0
*
- * @return @c true if an email attachment has inline-content(s), @n
+ * @return @c true if the email attachment has inline-content(s), @n
* else @c false
* @see SetInlineContentStatus()
*/
bool GetInlineContentStatus(void) const;
- /**
+ /**
* Gets the DRM status of an email attachment.
*
* @since 2.0
*
- * @return @c true if an email attachment contains DRM, @n
+ * @return @c true if the email attachment contains DRM, @n
* else @c false
* @see SetDrmStatus()
*/
bool GetDrmStatus(void) const;
- /**
+ /**
* Gets the MIME type of an email attachment.
*
* @since 2.0
*
- * @return The MIME type of an email attachment
+ * @return The MIME type of the email attachment
* @see SetMimeType()
*/
Tizen::Base::String GetMimeType(void) const;
///////////////////////////////////////////////////////////////
// Setters
///////////////////////////////////////////////////////////////
- /**
+ /**
* Sets the name of an email attachment.
*
* @since 2.0
*/
result SetName(const Tizen::Base::String& name);
- /**
+ /**
* Sets the file path of an email attachment.
*
* @since 2.0
*
* @return An error code
- * @param[in] filePath The file path of the attachment
+ * @param[in] filePath The file path of the email attachment
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The length of the specified @c filePath is too long or @c 0.
+ * @exception E_INVALID_ARG The length of the specified @c filePath is either too long or @c 0.
* @exception E_FILE_NOT_FOUND The specified file cannot be found or accessed.
* @see GetFilePath()
*/
result SetFilePath(const Tizen::Base::String& filePath);
- /**
+ /**
* Sets the inline-content status of an email attachment.
*
* @since 2.0
*/
void SetInlineContentStatus(bool status);
- /**
+ /**
* Sets the DRM status of an email attachment.
*
* @since 2.0
*/
void SetDrmStatus(bool status);
- /**
+ /**
* Sets the MIME type of an email attachment.
*
* @since 2.0
*
* @return An error code
- * @param[in] type The MIME type of the attachment
+ * @param[in] type The MIME type of the email attachment
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The length of the specified @c type is @c 0.
* @see GetMimeType()
// limitations under the License.
//
/**
- * @file FMsgEmailManager.h
+ * @file FMsgEmailManager.h
* @brief This is the header file for the %EmailManager class.
*
* This header file contains the declarations of the %EmailManager class.
// forward declaration for class extension
class _EmailManagerImpl;
- /**
+ /**
* @class EmailManager
* @brief This class provides methods to use the email messaging service.
*
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
EmailManager(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
// Operation
public:
- /**
+ /**
* Initializes this instance of %EmailManager with the specified parameter.
*
* @since 2.0
*
- * @return An error code
- * @param[in] listener The listener to receive a send result asynchronously
+ * @return An error code
+ * @param[in] listener The listener to receive the sent result asynchronously
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
*/
result Construct(IEmailListener& listener);
- /**
+ /**
* Sends the email message.
*
* @since 2.0
* @exception E_INVALID_ADDRESS The address is invalid.
* @exception E_FDN_MODE The FDN mode has been activated.
* @exception E_INVALID_ARG The number of recipients is @c 0.
- * @exception E_MAX_EXCEEDED The number of recipients has crossed the maximum limit (Maximum 20).
+ * @exception E_MAX_EXCEEDED The number of recipients has crossed the maximum limit (Maximum 20).
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @see IEmailListener::OnEmailMessageSent()
*/
result Send(const EmailMessage& message, const RecipientList& recipientList, bool saveToSentbox);
{
class _EmailMessageImpl;
- /**
+ /**
* @class EmailMessage
* @brief This class provides methods for handling email messages.
*
* @since 2.0
*
* The %EmailMessage class provides methods for handling email messages.
- * It allows you to set the subject and body text of an email message,
+ * It allows the user to set the subject and body text of an email message,
* and add or remove the files sent as email attachments.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
EmailMessage(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
*/
virtual ~EmailMessage(void);
- /**
+ /**
* This is the copy constructor for the %EmailMessage class.
*
* @since 2.0
*
- * @param[in] value An instance of %EmailMessage
+ * @param[in] value An instance of %EmailMessage to copy
*/
EmailMessage(const EmailMessage& value);
public:
- /**
- * This assignment operator copies an email message from the specified instance of %EmailMessage to the calling instance of %EmailMessage.
+ /**
+ * This assignment operator copies an email message from the specified instance of %EmailMessage to the current instance of %EmailMessage.
*
* @since 2.0
*
- * @return The reference of this instance
+ * @return A reference of this instance
* @param[in] rhs A reference to the %EmailMessage instance to copy
*/
EmailMessage& operator =(const EmailMessage& rhs);
- /**
- * Compares the calling instance with the specified instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if the specified instance of Tizen::Base::Object is equal to the calling %EmailMessage instance, @n
- * else @c false
- * @param[in] obj The object to compare
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %EmailMessage instance, @n
+ * else @c false
+ * @param[in] obj The object to compare
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
// Operation
public:
- /**
- * Sets the subject of the email.
+ /**
+ * Sets the subject of an email.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] subject The subject of the message
* @exception E_SUCCESS The method is successful.
- * @exception E_MAX_EXCEEDED The subject length of the message exceeds the maximum limit (Maximum 256 characters),
- * or the total size of the subject, body, and attachment(s) exceeds the maximum limit (5MB).
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The subject length of the message exceeds the maximum limit (Maximum 256 characters).
+ * - The total size of the subject, body, and attachment(s) exceeds the maximum limit (5MB).
* @see GetSubject()
*/
result SetSubject(const Tizen::Base::String& subject);
- /**
- * Sets the body of the message.
+ /**
+ * Sets the body of a message.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] text The body of the message
* @exception E_SUCCESS The method is successful.
- * @exception E_MAX_EXCEEDED The body length of the message exceeds the maximum limit (Maximum 2000 characters),
- * or the total size of the subject, body, and attachment(s) exceeds the maximum limit (5MB).
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The body length of the message exceeds the maximum limit (Maximum 2000 characters).
+ * - The total size of the subject, body, and attachment(s) exceeds the maximum limit (5MB).
* @see GetText()
*/
result SetText(const Tizen::Base::String& text);
- /**
- * Adds a file attachment to the email.
+
+ /**
+ * Adds a file attachment to an email.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* For more information, see @ref CompIoPathPage "here".
* @endif
*
- * @return An error code
+ * @return An error code
* @param[in] filePath The path of the file to attach
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The length of the specified @c filePath is too long or @c 0.
+ * @exception E_INVALID_ARG The length of the specified @c filePath is either too long or @c 0.
* @exception E_FILE_NOT_FOUND The specified file cannot be found or accessed.
* @exception E_FILE_ALREADY_EXIST The file is already attached.
- * @exception E_MAX_EXCEEDED The total size of the subject, body, and attachment(s) exceeds the maximum limit (5MB), or
- * the number of attachments exceeds the limit (20 files). @n
- * The total size of attachments must not exceed 5MB, and the total number of attached files must not exceed 20 files.
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The total size of the subject, body, and attachment(s) exceeds the maximum limit (5MB). @n
+ * The total size of the attachments must not exceed 5MB.
+ * - The total number of attachments exceeds the maximum limit (20 files). @n
+ * The total number of attached files must not exceed 20 files.
* @see GetAttachmentListN()
*/
result AddAttachment(const Tizen::Base::String& filePath);
- /**
+ /**
* Removes an attachment from an email.
*
* @if OSPCOMPAT
* For more information, see @ref CompIoPathPage "here".
* @endif
*
- * @return An error code
+ * @return An error code
* @param[in] filePath The path of the file to remove
* @exception E_SUCCESS The method is successful.
- * @exception E_FILE_NOT_FOUND The corresponding format file is not found.
+ * @exception E_FILE_NOT_FOUND The file with the corresponding format is not found.
* @see AddAttachment()
* @see GetAttachmentListN()
*/
result RemoveAttachment(const Tizen::Base::String& filePath);
- /**
- * Gets the subject of the message.
+ /**
+ * Gets the subject of a message.
*
* @since 2.0
*
*/
Tizen::Base::String GetSubject(void) const;
- /**
- * Gets the body of the message.
+ /**
+ * Gets the body of a message.
*
* @since 2.0
*
*/
Tizen::Base::String GetText(void) const;
- /**
- * Gets the list of attachments for the email.
+ /**
+ * Gets the list of attachments for an email.
*
* @since 2.0
*
- * @return The list of the attached files
+ * @return The list of attached files
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @remarks The specific error code can be accessed using the GetLastResult() method.
-//\r
-// Open Service Platform\r
-// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.\r
-//\r
-// Licensed under the Apache License, Version 2.0 (the License);\r
-// you may not use this file except in compliance with the License.\r
-// You may obtain a copy of the License at\r
-//\r
-// http://www.apache.org/licenses/LICENSE-2.0\r
-//\r
-// Unless required by applicable law or agreed to in writing, software\r
-// distributed under the License is distributed on an "AS IS" BASIS,\r
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
-// See the License for the specific language governing permissions and\r
-// limitations under the License.\r
-//\r
-/**\r
-* @file FMsgEtwsPrimaryNotification.h\r
-* @brief This is the header file for the %EtwsPrimaryNotification class.\r
-*\r
-* This header file contains the declarations of the %EtwsPrimaryNotification class.\r
-*/\r
-\r
-#ifndef _FMSG_ETWS_PRIMARY_NOTIFICATION_H_\r
-#define _FMSG_ETWS_PRIMARY_NOTIFICATION_H_\r
-\r
-namespace Tizen { namespace Base\r
-{\r
-class DateTime;\r
-class ByteBuffer;\r
-} }\r
-\r
-#include <FBaseObject.h>\r
-#include <FMsgTypes.h>\r
-\r
-namespace Tizen { namespace Messaging\r
-{\r
-\r
-class _EtwsPrimaryNotificationImpl;\r
-\r
-/**\r
-* @class EtwsPrimaryNotification\r
-*\r
-* @brief This class provides methods for handling an ETWS primary notification.\r
-*\r
-* @since 2.0\r
-*\r
-* @final This class is not intended for extension.\r
-*\r
-* The %EtwsPrimaryNotification class provides methods for handling an ETWS primary notification. It allows you to get the serial number,\r
-* message ID, warning type, warning security info, and received time of an ETWS primary notification.\r
-*/\r
-class _OSP_EXPORT_ EtwsPrimaryNotification\r
- : public Tizen::Base::Object\r
-{\r
-public:\r
- /**\r
- * This destructor overrides Tizen::Base::Object::~Object().\r
- *\r
- * @since 2.0\r
- */\r
- virtual ~EtwsPrimaryNotification(void);\r
-\r
- /**\r
- * Compares the specified instance of %EtwsPrimaryNotification with the calling instance.\r
- *\r
- * @since 2.0\r
- *\r
- * @return @c true if the values match, @n\r
- * else @c false\r
- * @param[in] obj The other Tizen::Base::Object to compare\r
- * @see Tizen::Base::Object::Equals()\r
- */\r
- virtual bool Equals(const Tizen::Base::Object& obj) const;\r
-\r
- /**\r
- * Gets the copied instance of the class.\r
- *\r
- * @since 2.0\r
- *\r
- * @return An instance of %EtwsPrimaryNotification @n\r
- * The value is @c null in case of an error.\r
- * @exception E_SUCCESS The method is successful.\r
- * @exception E_OUT_OF_MEMORY The memory is insufficient.\r
- *\r
- * @remarks The specific error code can be accessed using the GetLastResult() method.\r
- */\r
- EtwsPrimaryNotification* CloneN(void) const;\r
-\r
- /**\r
- * Gets the hash value of the current instance.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The current instance's hash value\r
- */\r
- virtual int GetHashCode(void) const;\r
-\r
- /**\r
- * Gets the date and time (UTC time) of the message when it is received.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The date and time (UTC time) when the message is received\r
- */\r
- Tizen::Base::DateTime GetReceivedTime(void) const;\r
-\r
- /**\r
- * Gets the serial number of the ETWS primary notification.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The serial number of the ETWS primary notification\r
- * @exception E_SUCCESS The method is successful.\r
- * @exception E_OUT_OF_MEMORY The memory is insufficient.\r
- * @remarks \r
- * - The specific error code can be accessed using the GetLastResult() method.\r
- * - In case of an error, this method returns @c null.\r
- */\r
- Tizen::Base::ByteBuffer* GetSerialNumberN(void) const;\r
-\r
- /**\r
- * Gets the message ID of the ETWS primary notification.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The message ID of the ETWS primary notification\r
- */\r
- int GetMessageId(void) const;\r
-\r
- /**\r
- * Gets the warning type.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The ETWS warning type of the message\r
- */\r
- Tizen::Base::ByteBuffer* GetWarningTypeN(void) const;\r
-\r
- /**\r
- * Gets the warning security information of the ETWS primary notification.\r
- *\r
- * @since 2.0\r
- *\r
- * @return The warning security information of the ETWS primary notification @n\r
- * The value is @c null in case of an error.\r
- * @exception E_SUCCESS The method is successful.\r
- * @exception E_OUT_OF_MEMORY The memory is insufficient.\r
- * @remarks The specific error code can be accessed using the GetLastResult() method.\r
- */\r
- Tizen::Base::ByteBuffer* GetWarningSecurityInfoN(void) const;\r
-\r
-private:\r
- /**\r
- * This default constructor is intentionally declared as private so that only the platform can create an instance.\r
- *\r
- * @since 2.0\r
- */\r
- EtwsPrimaryNotification(void);\r
-\r
- /**\r
- * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.\r
- *\r
- * @since 2.0\r
- *\r
- * @param[in] rhs An instance of EtwsPrimaryNotification\r
- */\r
- EtwsPrimaryNotification(const EtwsPrimaryNotification& rhs);\r
-\r
- /**\r
- * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects. @n\r
- * - Use CloneN() to get an exact copy of the instance.\r
- * - Use Equals() to compare the contents of one instance with the other.\r
- *\r
- * @since 2.0\r
- *\r
- * @return A reference to this instance\r
- * @param[in] rhs An instance of EtwsPrimaryNotification\r
- */\r
- EtwsPrimaryNotification& operator =(const EtwsPrimaryNotification& rhs);\r
-\r
-private:\r
- _EtwsPrimaryNotificationImpl* __pEtwsPrimaryNotificationImpl;\r
-\r
- friend class _EtwsPrimaryNotificationImpl;\r
-}; // EtwsPrimaryNotification\r
-\r
-} } // Tizen::Messaging\r
-#endif // _FMSG_ETWS_PRIMARY_NOTIFICATION_H_\r
+//
+// Open Service Platform
+// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+/**
+ * @file FMsgEtwsPrimaryNotification.h
+ * @brief This is the header file for the %EtwsPrimaryNotification class.
+ *
+ * This header file contains the declarations of the %EtwsPrimaryNotification class.
+ */
+
+#ifndef _FMSG_ETWS_PRIMARY_NOTIFICATION_H_
+#define _FMSG_ETWS_PRIMARY_NOTIFICATION_H_
+
+namespace Tizen { namespace Base
+{
+class DateTime;
+class ByteBuffer;
+} }
+
+#include <FBaseObject.h>
+#include <FMsgTypes.h>
+
+namespace Tizen { namespace Messaging
+{
+
+class _EtwsPrimaryNotificationImpl;
+
+/**
+ * @class EtwsPrimaryNotification
+ *
+ * @brief This class provides methods for handling an ETWS primary notification.
+ *
+ * @since 2.0
+ *
+ * @final This class is not intended for extension.
+ *
+ * The %EtwsPrimaryNotification class provides methods for handling an ETWS primary notification. It allows the user to get the serial number,
+ * message ID, warning type, warning security info, and received time of an ETWS primary notification.
+ */
+class _OSP_EXPORT_ EtwsPrimaryNotification
+ : public Tizen::Base::Object
+{
+public:
+ /**
+ * This destructor overrides Tizen::Base::Object::~Object().
+ *
+ * @since 2.0
+ */
+ virtual ~EtwsPrimaryNotification(void);
+
+ /**
+ * Compares the specified instance of %EtwsPrimaryNotification with the current instance.
+ *
+ * @since 2.0
+ *
+ * @return @c true if the values match, @n
+ * else @c false
+ * @param[in] obj The other Tizen::Base::Object to compare
+ * @see Tizen::Base::Object::Equals()
+ */
+ virtual bool Equals(const Tizen::Base::Object& obj) const;
+
+ /**
+ * Gets the copied instance of this class.
+ *
+ * @since 2.0
+ *
+ * @return An instance of %EtwsPrimaryNotification, @n
+ * else @c null in case of an error
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ *
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ */
+ EtwsPrimaryNotification* CloneN(void) const;
+
+ /**
+ * Gets the hash value of the current instance.
+ *
+ * @since 2.0
+ *
+ * @return The hash value of the current instance
+ */
+ virtual int GetHashCode(void) const;
+
+ /**
+ * Gets the date and time (UTC time) of a message when it is received.
+ *
+ * @since 2.0
+ *
+ * @return The date and time (UTC time) when the message is received
+ */
+ Tizen::Base::DateTime GetReceivedTime(void) const;
+
+ /**
+ * Gets the serial number of an ETWS primary notification.
+ *
+ * @since 2.0
+ *
+ * @return The serial number of the ETWS primary notification, @n
+ * else @c null in case of an error
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ */
+ Tizen::Base::ByteBuffer* GetSerialNumberN(void) const;
+
+ /**
+ * Gets the message ID of an ETWS primary notification.
+ *
+ * @since 2.0
+ *
+ * @return The message ID of the ETWS primary notification
+ */
+ int GetMessageId(void) const;
+
+ /**
+ * Gets the warning type of a message.
+ *
+ * @since 2.0
+ *
+ * @return The ETWS warning type of the message
+ */
+ Tizen::Base::ByteBuffer* GetWarningTypeN(void) const;
+
+ /**
+ * Gets the warning security information of an ETWS primary notification.
+ *
+ * @since 2.0
+ *
+ * @return The warning security information of the ETWS primary notification, @n
+ * else @c null in case of an error
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
+ */
+ Tizen::Base::ByteBuffer* GetWarningSecurityInfoN(void) const;
+
+private:
+ /**
+ * This default constructor is intentionally declared as private so that only the platform can create an instance.
+ *
+ * @since 2.0
+ */
+ EtwsPrimaryNotification(void);
+
+ /**
+ * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
+ *
+ * @since 2.0
+ *
+ * @param[in] rhs An instance of EtwsPrimaryNotification
+ */
+ EtwsPrimaryNotification(const EtwsPrimaryNotification& rhs);
+
+ /**
+ * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects. @n
+ * - Use CloneN() to get an exact copy of the instance.
+ * - Use Equals() to compare the contents of one instance with the other.
+ *
+ * @since 2.0
+ *
+ * @return A reference to this instance
+ * @param[in] rhs An instance of EtwsPrimaryNotification
+ */
+ EtwsPrimaryNotification& operator =(const EtwsPrimaryNotification& rhs);
+
+private:
+ _EtwsPrimaryNotificationImpl* __pEtwsPrimaryNotificationImpl;
+
+ friend class _EtwsPrimaryNotificationImpl;
+}; // EtwsPrimaryNotification
+
+} } // Tizen::Messaging
+#endif // _FMSG_ETWS_PRIMARY_NOTIFICATION_H_
-//\r
-// Open Service Platform\r
-// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.\r
-//\r
-// Licensed under the Apache License, Version 2.0 (the License);\r
-// you may not use this file except in compliance with the License.\r
-// You may obtain a copy of the License at\r
-//\r
-// http://www.apache.org/licenses/LICENSE-2.0\r
-//\r
-// Unless required by applicable law or agreed to in writing, software\r
-// distributed under the License is distributed on an "AS IS" BASIS,\r
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
-// See the License for the specific language governing permissions and\r
-// limitations under the License.\r
-//\r
-/**\r
-* @file FMsgICbsMessageEventListener.h\r
-* @brief This is the header file for the %ICbsMessageEventListener interface.\r
-*\r
-* This header file contains the declarations of the %ICbsMessageEventListener interface.\r
-*/\r
-\r
-#ifndef _FMSG_ICBS_MESSAGE_EVENT_LISTENER_H_\r
-#define _FMSG_ICBS_MESSAGE_EVENT_LISTENER_H_\r
-\r
-namespace Tizen { namespace Messaging\r
-{\r
- class CbsMessage;\r
-\r
- /**\r
- * @interface ICbsMessageEventListener\r
- * @brief This interface is the listener interface for receiving CBS messages.\r
- *\r
- * @since 2.0\r
- *\r
- * The %ICbsMessageEventListener interface must be implemented to handle incoming CBS messages. An application must register this interface using the SmsManager::SetCbsMessageEventListener() method.\r
- */\r
- class _OSP_EXPORT_ ICbsMessageEventListener\r
- : virtual public Tizen::Base::Runtime::IEventListener\r
- {\r
- public:\r
- /**\r
- * This polymorphic destructor should be overridden if required. @n\r
- * This way, the destructors of the derived classes are called when the destructor of this interface is called.\r
- *\r
- * @since 2.0\r
- */\r
- virtual ~ICbsMessageEventListener(void) {}\r
-\r
- /**\r
- * Called when a CBS message is received.\r
- *\r
- * @since 2.0\r
- *\r
- * @param[in] message The message that is received\r
- * @see SmsManager::SetCbsMessageEventListener()\r
- */\r
- virtual void OnCbsMessageReceived(const CbsMessage& message) = 0;\r
-\r
- protected:\r
- //\r
- // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.\r
- //\r
- // This method is reserved and may change its name at any time without prior notice.\r
- //\r
- // @since 2.0\r
- //\r
- virtual void ICbsMessageEventListener_Reserved1(void) {}\r
-\r
- //\r
- // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.\r
- //\r
- // This method is reserved and may change its name at any time without prior notice.\r
- //\r
- // @since 2.0\r
- //\r
- virtual void ICbsMessageEventListener_Reserved2(void) {}\r
- }; // ICbsMessageEventListener\r
-} } // Tizen::Messaging\r
-#endif // _FMSG_ICBS_MESSAGE_EVENT_LISTENER_H_\r
+//
+// Open Service Platform
+// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+/**
+ * @file FMsgICbsMessageEventListener.h
+ * @brief This is the header file for the %ICbsMessageEventListener interface.
+ *
+ * This header file contains the declarations of the %ICbsMessageEventListener interface.
+ */
+
+#ifndef _FMSG_ICBS_MESSAGE_EVENT_LISTENER_H_
+#define _FMSG_ICBS_MESSAGE_EVENT_LISTENER_H_
+
+namespace Tizen { namespace Messaging
+{
+ class CbsMessage;
+
+ /**
+ * @interface ICbsMessageEventListener
+ * @brief This interface is the listener interface for receiving CBS messages.
+ *
+ * @since 2.0
+ *
+ * The %ICbsMessageEventListener interface must be implemented to handle incoming CBS messages. An application must register this interface using the %SmsManager::SetCbsMessageEventListener() method.
+ */
+ class _OSP_EXPORT_ ICbsMessageEventListener
+ : virtual public Tizen::Base::Runtime::IEventListener
+ {
+ public:
+ /**
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ *
+ * @since 2.0
+ */
+ virtual ~ICbsMessageEventListener(void) {}
+
+ /**
+ * Called when a CBS message is received.
+ *
+ * @since 2.0
+ *
+ * @param[in] message The message that is received
+ * @see SmsManager::SetCbsMessageEventListener()
+ */
+ virtual void OnCbsMessageReceived(const CbsMessage& message) = 0;
+
+ protected:
+ //
+ // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
+ //
+ // This method is reserved and may change its name at any time without prior notice.
+ //
+ // @since 2.0
+ //
+ virtual void ICbsMessageEventListener_Reserved1(void) {}
+
+ //
+ // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
+ //
+ // This method is reserved and may change its name at any time without prior notice.
+ //
+ // @since 2.0
+ //
+ virtual void ICbsMessageEventListener_Reserved2(void) {}
+ }; // ICbsMessageEventListener
+} } // Tizen::Messaging
+#endif // _FMSG_ICBS_MESSAGE_EVENT_LISTENER_H_
namespace Tizen { namespace Messaging
{
- /**
+ /**
* @interface IEmailListener
- * @brief This interface is the listener interface for receiving email sent status.
+ * @brief This interface is the listener interface for receiving the status of a sent email.
*
* @since 2.0
*
- * The %IEmailListener interface must be implemented to receive the status of the sent email messages asynchronously. An application must register this interface using the EmailManager::Construct() method.
+ * The %IEmailListener interface must be implemented to receive the status of sent email messages asynchronously. An application must register this interface using the %EmailManager::Construct() method.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
*/
{
// Lifecycle
public:
- /**
- * This is the destructor for this class.
- *
- * @since 2.0
- */
+ /**
+ * This is the destructor for this class.
+ *
+ * @since 2.0
+ */
virtual ~IEmailListener(void) {}
// Operation
public:
- /**
- * Called when the email message is sent.
+ /**
+ * Called when an email message is sent.
*
* @since 2.0
*
-//\r
-// Open Service Platform\r
-// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.\r
-//\r
-// Licensed under the Apache License, Version 2.0 (the License);\r
-// you may not use this file except in compliance with the License.\r
-// You may obtain a copy of the License at\r
-//\r
-// http://www.apache.org/licenses/LICENSE-2.0\r
-//\r
-// Unless required by applicable law or agreed to in writing, software\r
-// distributed under the License is distributed on an "AS IS" BASIS,\r
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
-// See the License for the specific language governing permissions and\r
-// limitations under the License.\r
-//\r
-/**\r
-* @file FMsgIEtwsPrimaryNotificationEventListener.h\r
-* @brief This is the header file for the %IEtwsPrimaryNotificationEventListener interface.\r
-*\r
-* This header file contains the declarations of the %IEtwsPrimaryNotificationEventListener interface.\r
-*/\r
-\r
-#ifndef _FMSG_IETWS_PRIMARY_NOTIFICATION_EVENT_LISTENER_H_\r
-#define _FMSG_IETWS_PRIMARY_NOTIFICATION_EVENT_LISTENER_H_\r
-\r
-#include <FMsgICbsMessageEventListener.h>\r
-\r
-namespace Tizen { namespace Messaging\r
-{\r
- class EtwsPrimaryNotification;\r
-\r
- /**\r
- * @interface IEtwsPrimaryNotificationEventListener\r
- * @brief This interface is the listener interface for receiving ETWS primary notification.\r
- *\r
- * @since 2.0\r
- *\r
- * The %IEtwsPrimaryNotificationEventListener interface must be implemented to handle incoming ETWS primary notification.\r
- * An application must register this interface using the SmsManager::SetEtwsPrimaryNotificationEventListener() method.\r
- */\r
- class _OSP_EXPORT_ IEtwsPrimaryNotificationEventListener\r
- : virtual public Tizen::Messaging::ICbsMessageEventListener\r
- {\r
- public:\r
- /**\r
- * This polymorphic destructor should be overridden if required. @n\r
- * This way, the destructors of the derived classes are called when the destructor of this interface is called.\r
-\r
- *\r
- * @since 2.0\r
- */\r
- virtual ~IEtwsPrimaryNotificationEventListener(void) {}\r
-\r
- /**\r
- * Called when the ETWS primary notification is received.\r
- *\r
- * @since 2.0\r
- *\r
- * @param[in] message The ETWS primary notification that is received\r
- * @see SmsManager::SetEtwsPrimaryNotificationEventListener()\r
- */\r
- virtual void OnEtwsPrimaryNotificationReceived(const EtwsPrimaryNotification& message) = 0;\r
-\r
- protected:\r
- //\r
- // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.\r
- //\r
- // This method is reserved and may change its name at any time without prior notice.\r
- //\r
- // @since 2.0\r
- //\r
- virtual void IEtwsPrimaryNotificationEventListener_Reserved1(void) {}\r
-\r
- //\r
- // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.\r
- //\r
- // This method is reserved and may change its name at any time without prior notice.\r
- //\r
- // @since 2.0\r
- //\r
- virtual void IEtwsPrimaryNotificationEventListener_Reserved2(void) {}\r
- }; // IEtwsPrimaryNotificationEventListener\r
-} } // Tizen::Messaging\r
-#endif // _FMSG_IETWS_PRIMARY_NOTIFICATION_EVENT_LISTENER_H_\r
+//
+// Open Service Platform
+// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the License);
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+/**
+ * @file FMsgIEtwsPrimaryNotificationEventListener.h
+ * @brief This is the header file for the %IEtwsPrimaryNotificationEventListener interface.
+ *
+ * This header file contains the declarations of the %IEtwsPrimaryNotificationEventListener interface.
+ */
+
+#ifndef _FMSG_IETWS_PRIMARY_NOTIFICATION_EVENT_LISTENER_H_
+#define _FMSG_IETWS_PRIMARY_NOTIFICATION_EVENT_LISTENER_H_
+
+#include <FMsgICbsMessageEventListener.h>
+
+namespace Tizen { namespace Messaging
+{
+ class EtwsPrimaryNotification;
+
+ /**
+ * @interface IEtwsPrimaryNotificationEventListener
+ * @brief This interface is the listener interface for receiving an ETWS primary notification.
+ *
+ * @since 2.0
+ *
+ * The %IEtwsPrimaryNotificationEventListener interface must be implemented to handle an incoming ETWS primary notification. @n
+ * An application must register this interface using the SmsManager::SetEtwsPrimaryNotificationEventListener() method.
+ */
+ class _OSP_EXPORT_ IEtwsPrimaryNotificationEventListener
+ : virtual public Tizen::Messaging::ICbsMessageEventListener
+ {
+ public:
+ /**
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ *
+ *
+ * @since 2.0
+ */
+ virtual ~IEtwsPrimaryNotificationEventListener(void) {}
+
+ /**
+ * Called when an ETWS primary notification is received.
+ *
+ * @since 2.0
+ *
+ * @param[in] message The ETWS primary notification that is received
+ * @see SmsManager::SetEtwsPrimaryNotificationEventListener()
+ */
+ virtual void OnEtwsPrimaryNotificationReceived(const EtwsPrimaryNotification& message) = 0;
+
+ protected:
+ //
+ // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
+ //
+ // This method is reserved and may change its name at any time without prior notice.
+ //
+ // @since 2.0
+ //
+ virtual void IEtwsPrimaryNotificationEventListener_Reserved1(void) {}
+
+ //
+ // This method is for internal use only. Using this method can cause behavioral, security-related, and consistency-related issues in the application.
+ //
+ // This method is reserved and may change its name at any time without prior notice.
+ //
+ // @since 2.0
+ //
+ virtual void IEtwsPrimaryNotificationEventListener_Reserved2(void) {}
+ }; // IEtwsPrimaryNotificationEventListener
+} } // Tizen::Messaging
+#endif // _FMSG_IETWS_PRIMARY_NOTIFICATION_EVENT_LISTENER_H_
{
- /**
+ /**
* @interface IMmsListener
- * @brief This interface is the listener interface for receiving MMS sent status.
+ * @brief This interface is the listener interface for receiving the status of a sent MMS.
*
* @since 2.0
*
- * The %IMmsListener interface must be implemented to receive the status of the sent MMS messages asynchronously. An application must register this interface using the MmsManager::Construct() method.
+ * The %IMmsListener interface must be implemented to receive the status of sent MMS messages asynchronously. An application must register this interface using the %MmsManager::Construct() method.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
*/
{
// Lifecycle
public:
- /**
- * This is the destructor for this class.
- *
- * @since 2.0
- */
+ /**
+ * This is the destructor for this class.
+ *
+ * @since 2.0
+ */
virtual ~IMmsListener(void) {}
// Operation
public:
- /**
- * Called when the Multimedia Messaging Service(MMS) message is sent.
+ /**
+ * Called when a Multimedia Messaging Service(MMS) message is sent.
*
* @since 2.0
*
namespace Tizen { namespace Messaging
{
/**
-* @interface IPushEventListener
-* @brief This interface is the listener interface for receiving push messages.
-*
-* @since 2.0
-*
-* The %IPushEventListener interface must be implemented to receive the push messages. An application must register this interface using the PushManager::Construct() method.
-*/
+ * @interface IPushEventListener
+ * @brief This interface is the listener interface for receiving push messages.
+ *
+ * @since 2.0
+ *
+ * The %IPushEventListener interface must be implemented to receive push messages. @n
+ * An application must register this interface using the PushManager::Construct() method.
+ */
class _OSP_EXPORT_ IPushEventListener
: virtual public Tizen::Base::Runtime::IEventListener
{
public:
- /**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
- *
- * @since 2.0
- */
+ /**
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ *
+ * @since 2.0
+ */
virtual ~IPushEventListener(void) {}
public:
- /**
+ /**
* Called when a push message is received from the server.
*
* @since 2.0
*
- * @param[in] message The push message
+ * @param[in] message The push message that is received
*/
virtual void OnPushMessageReceived(const PushMessage& message) = 0;
namespace Tizen { namespace Messaging
{
/**
-* @interface IPushManagerListener
-* @brief This interface is the listener interface that receives the registration result.
-*
-* @since 2.0
-*
-* The %IPushManagerListener interface must be implemented to receive results of the push event registration. An application must register this interface using the PushManager::Construct() method.
-*/
+ * @interface IPushManagerListener
+ * @brief This interface is the listener interface that receives a registration result.
+ *
+ * @since 2.0
+ *
+ * The %IPushManagerListener interface must be implemented to receive the results of a push event registration. @n
+ * An application must register this interface using the PushManager::Construct() method.
+ */
class _OSP_EXPORT_ IPushManagerListener
: virtual public Tizen::Base::Runtime::IEventListener
{
public:
- /**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
- *
- * @since 2.0
- */
+ /**
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ *
+ * @since 2.0
+ */
virtual ~IPushManagerListener(void) {}
public:
- /**
+ /**
* Called when the result is received from PushManager::RegisterPushService().
*
* @since 2.0
*
- * @param[in] reqId The request ID
- * @param[in] registrationId The registration ID of the device @n
- * The application must deliver this ID to the application server.
- * @param[in] r The result of the request
- * @param[in] errorCode The error code from the server
- * @param[in] errorMsg The error message from the server
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM An unknown operating system error has occurred.
- * @exception E_CONNECTION_FAILED The network connection has failed.
- * @exception E_SERVER An error has occurred on the server side.
+ * @param[in] reqId The request ID
+ * @param[in] registrationId The registration ID of the device @n
+ * The application must deliver this ID to the application server.
+ * @param[in] r The result of the request
+ * @param[in] errorCode The error code from the server
+ * @param[in] errorMsg The error message from the server
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM An unknown operating system error has occurred.
+ * @exception E_CONNECTION_FAILED The network connection has failed.
+ * @exception E_SERVER An error has occurred on the server side.
* @exception E_SERVICE_UNAVAILABLE The service is unavailable. @n
- * Check whether the push service registration is completed. For more information, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * Check whether the push service registration is completed. @n
+ * For more information, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
* @see PushManager::RegisterPushService()
*/
virtual void OnPushServiceRegistered(RequestId reqId, const Tizen::Base::String& registrationId, result r, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMsg) = 0;
- /**
+ /**
* Called when the result is received from PushManager::UnregisterPushService().
*
* @since 2.0
*/
virtual void OnPushServiceUnregistered(RequestId reqId, result r, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMsg) = 0;
- /**
+ /**
* Called when the result is received from PushManager::SendPushMessage().
*
* @since 2.0
* @param[in] reqId The request ID
* @param[in] registrationId The registration ID of the recipient
* @param[in] r The result of the request, @n
- * The following exceptions may be given through this parameter.
+ * The following exceptions may be given through this parameter.
* @param[in] errorCode The error code from the server
* @param[in] errorMsg The error message from the server
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_DATA An invalid data is received from the server.
+ * @exception E_INVALID_DATA Invalid data is received from the server.
* @exception E_CONNECTION_FAILED The network connection has failed.
* @exception E_REMOTE_DEVICE_NOT_FOUND The registration ID is invalid, so the recipient is not found.
- * @exception E_AUTHENTICATION The appSecret is invalid, so application authentication has failed.
+ * @exception E_AUTHENTICATION The appSecret is invalid, so the application authentication has failed.
* @exception E_SERVER An error has occurred on the server side.
* @exception E_SERVICE_UNAVAILABLE The service is unavailable. @n
- * Check whether the push service registration is completed. For more information, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * Check whether the push service registration is completed. @n
+ * For more information, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
* @see PushManager::SendPushMessage()
*/
virtual void OnPushMessageSent(RequestId reqId, const Tizen::Base::String& registrationId, result r, const Tizen::Base::String& errorCode, const Tizen::Base::String& errorMsg) {}
class SmsMessage;
- /**
+ /**
* @interface ISmsEventListener
* @brief This interface is the listener interface for receiving SMS messages.
*
* @since 2.0
*
- * The %ISmsEventListener interface is the listener interface for receiving SMS messages via a specific port.
- * An application implements this interface and registers it using the SmsManager::AddSmsEventListener() method to receive SMS messages.
+ * The %ISmsEventListener interface is the listener interface for receiving SMS messages via a specific port. @n
+ * An application implements this interface and registers it using the SmsManager::AddSmsEventListener() method to receive SMS messages.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
*/
{
// Lifecycle
public:
- /**
- * This is the destructor for this class.
- *
- * @since 2.0
- */
+ /**
+ * This is the destructor for this class.
+ *
+ * @since 2.0
+ */
virtual ~ISmsEventListener(void) {}
// Operations
public:
- /**
+ /**
* Called when an SMS message is received.
*
* @since 2.0
*
- * @param[in] port A port number
+ * @param[in] port The port number
* @param[in] dateTime The date and time when the message is received
* @param[in] message The message that is received
- * @see SmsManager::AddSmsEventListener()
- * @see SmsManager::RemoveSmsEventListener()
+ * @see SmsManager::AddSmsEventListener()
+ * @see SmsManager::RemoveSmsEventListener()
*/
virtual void OnSmsMessageReceived(int port, const Tizen::Base::DateTime& dateTime, const SmsMessage& message) = 0;
namespace Tizen { namespace Messaging
{
- /**
+ /**
* @interface ISmsListener
- * @brief This interface is the listener interface for receiving SMS sent status.
+ * @brief This interface is the listener interface for receiving the status of a sent SMS.
*
* @since 2.0
*
- * The %ISmsListener interface must be implemented to receive the status of the sent SMS messages asynchronously. An application must register this interface using the SmsManager::Construct() method.
+ * The %ISmsListener interface must be implemented and registered using the SmsManager::Construct() method to receive the status of sent SMS messages asynchronously.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
*/
{
// Lifecycle
public:
- /**
- * This is the destructor for this class.
- *
- * @since 2.0
- */
+ /**
+ * This is the destructor for this class.
+ *
+ * @since 2.0
+ */
virtual ~ISmsListener(void) {}
// Operation
public:
- /**
- * Called when the SMS message is sent.
+ /**
+ * Called when an SMS message is sent.
*
* @since 2.0
*
// limitations under the License.
//
/**
- * @file FMsgISmsMessageEventListener.h
+ * @file FMsgISmsMessageEventListener.h
* @brief This is the header file for the %ISmsMessageEventListener interface.
*
* This header file contains the declarations of the %ISmsMessageEventListener interface.
{
class SmsMessage;
- /**
+ /**
* @interface ISmsMessageEventListener
* @brief This interface is the listener interface for receiving SMS messages.
*
* @since 2.0
*
- * The %ISmsMessageEventListener interface must be implemented to handle incoming SMS messages. An application must register this interface using the SmsManager::AddSmsMessageEventListener() method.
+ * The %ISmsMessageEventListener interface must be implemented and registered using the SmsManager::AddSmsMessageEventListener() method to handle incoming SMS messages.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
*/
{
// Lifecycle
public:
- /**
- * This is the destructor for this class.
- *
- * @since 2.0
- */
+ /**
+ * This is the destructor for this class.
+ *
+ * @since 2.0
+ */
virtual ~ISmsMessageEventListener(void) {}
// Operations
public:
- /**
- * Called when the SMS message is received.
+ /**
+ * Called when an SMS message is received.
*
* @since 2.0
*
* @param[in] message The message that is received
* @see SmsManager::AddSmsMessageEventListener()
- * @see SmsManager::RemoveSmsMessageEventListener()
+ * @see SmsManager::RemoveSmsMessageEventListener()
*/
virtual void OnSmsMessageReceived(const SmsMessage& message) = 0;
// limitations under the License.
//
/**
-* @file FMsgIWapPushEventListener.h
-* @brief This is the header file for the %IWapPushEventListener interface.
-*
-* This header file contains the declarations of the %IWapPushEventListener interface.
-*/
+ * @file FMsgIWapPushEventListener.h
+ * @brief This is the header file for the %IWapPushEventListener interface.
+ *
+ * This header file contains the declarations of the %IWapPushEventListener interface.
+ */
#ifndef _FMSG_IWAP_PUSH_EVENT_LISTENER_H_
#define _FMSG_IWAP_PUSH_EVENT_LISTENER_H_
namespace Tizen { namespace Messaging
{
/**
-* @interface IWapPushEventListener
-* @brief This interface is the listener interface for receiving WAP Push messages.
-*
-* @since 2.0
-*
-* The %IWapPushEventListener interface must be implemented to receive WAP Push messages. An application must register this interface using the WapPushManager::AddWapPushEventListener() method.
-*/
+ * @interface IWapPushEventListener
+ * @brief This interface is the listener interface for receiving WAP Push messages.
+ *
+ * @since 2.0
+ *
+ * The %IWapPushEventListener interface must be implemented to receive WAP Push messages.
+ * An application must register this interface using the WapPushManager::AddWapPushEventListener() method.
+ */
class _OSP_EXPORT_ IWapPushEventListener
: virtual public Tizen::Base::Runtime::IEventListener
{
public:
- /**
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived
- * classes are called when the destructor of this interface is called.
+ /**
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @since 2.0
*/
virtual ~IWapPushEventListener(void) {}
public:
- /**
+ /**
* Called when a WAP Push message is received.
*
* @since 2.0
// limitations under the License.
//
/**
- * @file FMsgMmsManager.h
+ * @file FMsgMmsManager.h
* @brief This is the header file for the %MmsManager class.
*
* This header file contains the declarations of the %MmsManager class.
// forward declaration for class extension
class _MmsManagerImpl;
- /**
+ /**
* @class MmsManager
- * @brief This class provides methods to use the MMS messaging service.
+ * @brief This class provides methods to use the Multimedia Messaging Service.
*
* @since 2.0
*
- * The %MmsManager class is used to send MMS messages.
+ * The %MmsManager class is used to send Multimedia Messaging Service.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
*
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
MmsManager(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
// Operation
public:
- /**
+ /**
* Initializes this instance of %MmsManager with the specified parameter.
*
* @since 2.0
*
* @feature %http://tizen.org/feature/network.telephony.mms
* @return An error code
- * @param[in] listener The listener to receive a send result asynchronously
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @param[in] listener The listener to receive the sent result asynchronously
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by
+ * @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
*/
- result Construct(IMmsListener &listener);
+ result Construct(IMmsListener &listener);
- /**
- * Sends the MMS message.
+ /**
+ * Sends the specified MMS message.
*
* @since 2.0
* @privlevel public
* @exception E_INVALID_CONDITION The profile is not set.
* @exception E_INVALID_ADDRESS The address is invalid.
* @exception E_FDN_MODE The FDN mode has been activated.
- * @exception E_INVALID_ARG The number of recipients is @c 0 or the message is empty.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The number of recipients is @c 0.
+ * - The message is empty.
* @exception E_MAX_EXCEEDED The number of recipients has crossed the maximum limit (Maximum 10).
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks
- * - Some service providers may not support sending MMS messages with an empty subject or body. @n
- * In this case, the result of the status report will be the E_FAILURE exception.
- * - The CC and BCC recipients in the @c recipientList are merged with the TO recipients when sending an MMS message.
- * @see IMmsListener::OnMmsMessageSent()
+ * - Some service providers may not support sending MMS messages with an empty subject or body. @n
+ * In this case, the result of the status report is the @c E_FAILURE exception.
+ * - The CC and BCC recipients in the @c recipientList are merged with the TO recipients when sending an MMS message.
+ * @see IMmsListener::OnMmsMessageSent()
*/
result Send(const MmsMessage& message, const RecipientList& recipientList, bool saveToSentbox);
// forward declaration
class _MmsMessageImpl;
- /**
+ /**
* @class MmsMessage
* @brief This class provides methods for handling an MMS message.
*
* @since 2.0
*
- * The %MmsMessage class provides methods for handling MMS messages. It allows you to set
+ * The %MmsMessage class provides methods for handling MMS messages. It allows the user to set
* the subject and body text of an MMS message, and add or remove the files sent as MMS attachments.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
MmsMessage(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
*/
virtual ~MmsMessage(void);
- /**
+ /**
* This is the copy constructor for the %MmsMessage class.
*
* @since 2.0
*
- * @param[in] value An instance of %MmsMessage
+ * @param[in] value An instance of %MmsMessage to copy
*/
MmsMessage(const MmsMessage& value);
- /**
- * This assignment operator copies an MMS message from the specified instance of %MmsMessage to the calling instance of %MmsMessage.
+ /**
+ * This assignment operator copies the MMS message from the specified instance of %MmsMessage to the current instance of %MmsMessage.
*
* @since 2.0
*
*/
MmsMessage& operator =(const MmsMessage& rhs);
- /**
- * Compares the calling instance with the specified instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if the specified instance of Tizen::Base::Object is equal to the calling %MmsMessage instance, @n
- * else @c false
- * @param[in] obj The object to compare
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %MmsMessage instance, @n
+ * else @c false
+ * @param[in] obj The object to compare
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
*
- * @return The hash value of the current instance
+ * @return The hash value of the current instance
*/
virtual int GetHashCode(void) const;
// Operation
public:
- /**
- * Sets the subject of the MMS message.
+ /**
+ * Sets the subject of an MMS message.
*
* @since 2.0
*
* @return An error code
* @param[in] subject The subject of the MMS message
* @exception E_SUCCESS The method is successful.
- * @exception E_MAX_EXCEEDED The subject length of the message exceeds the maximum limit (Maximum 40 characters). @n
- * The total size of the subject, body, and attachment(s) exceeds the maximum limit (295KB).
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The subject length of the message exceeds the maximum limit (Maximum 40 characters).
+ * - The total size of the subject, body, and attachment(s) exceeds the maximum limit (295KB).
* @see GetSubject()
*/
result SetSubject(const Tizen::Base::String& subject);
- /**
- * Sets the body of the MMS message.
+ /**
+ * Sets the body of an MMS message.
*
* @since 2.0
*
* @return An error code
* @param[in] text The body of the MMS message
* @exception E_SUCCESS The method is successful.
- * @exception E_MAX_EXCEEDED The body length of the message exceeds the maximum limit (Maximum 1000 characters). @n
- * The total size of the subject, body, and attachment(s) exceeds the maximum limit (295KB).
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The body length of the message exceeds the maximum limit (Maximum 1000 characters).
+ * - The total size of the subject, body, and attachment(s) exceeds the maximum limit (295KB).
* @see GetText()
*/
result SetText(const Tizen::Base::String& text);
- /**
- * Adds the attachment of the specific type.
+ /**
+ * Adds the attachment of the specified type.
*
* @if OSPCOMPAT
- * @brief <i> [Compatibility] </i>
+ * @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
* @compatibility This method has compatibility issues with OSP compatible applications. @n
* For more information, see @ref CompIoPathPage "here".
* @param[in] filePath The path of the file to attach
* @exception E_SUCCESS The method is successful.
* @exception E_FILE_NOT_FOUND The specified file cannot be found or accessed.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The length of the specified @c filePath is too long or @c 0. @n
- * - The specified file format is already attached. @n
- * - The specified @c format is invalid. @n
- * - The specified file contains invalid or the media is not supported. @n
- * - The specified file format cannot be attached. @n
- * (An MMS attachment may contain either an image, audio, video, vCard, or a vCalendar file or a combination of an image, audio, vCard, and vCalendar file. @n
- * MMS attachments cannot contain a video file in combination with an image or audio file.)
- * @exception E_MAX_EXCEEDED The size of the file exceeds the maximum limit (Maximum 295KB). @n
- * The total size of the subject, body, and attachment(s) exceeds the maximum limit (295KB).
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of the specified @c filePath is either too long or @c 0.
+ * - The specified file format is already attached.
+ * - The specified @c format is invalid.
+ * - The specified file contains invalid data.
+ * - The media is not supported.
+ * - The specified file format cannot be attached.
+ * (An MMS attachment may contain either an image, audio, video, vCard, or a vCalendar file or a combination of an image, audio, vCard, and vCalendar file. @n
+ * MMS attachments cannot contain a video file in combination with an image or audio file.)
+ * @exception E_MAX_EXCEEDED Either of the following conditions has occurred:
+ * - The size of the file exceeds the maximum limit (Maximum 295KB).
+ * - The total size of the subject, body, and attachment(s) exceeds the maximum limit (295KB).
* @see GetAttachment()
*/
result AddAttachment(MmsAttachmentFormat format, const Tizen::Base::String& filePath);
- /**
- * Gets the subject of the MMS message.
+ /**
+ * Gets the subject of an MMS message.
*
* @since 2.0
*
*/
Tizen::Base::String GetSubject(void) const;
- /**
- * Gets the body of the MMS message.
+ /**
+ * Gets the body of an MMS message.
*
* @since 2.0
*
*/
Tizen::Base::String GetText(void) const;
- /**
- * Gets the attachment file of the specific type.
+ /**
+ * Gets the attachment file of the specified type.
*
* @since 2.0
*
- * @return The path of the attached file
+ * @return The path of the attached file
* @param[in] format The format of the attachment
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_CONDITION The file is not attached.
* @exception E_INVALID_ARG The specified @c format is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
- * @see AddAttachment()
+ * @see AddAttachment()
*/
Tizen::Base::String GetAttachment(MmsAttachmentFormat format) const;
- /**
- * Removes the attachment of the specific type.
+ /**
+ * Removes the attachment of the specified type.
*
* @since 2.0
*
* @return An error code
* @param[in] format The format of the attachment to remove
* @exception E_SUCCESS The method is successful.
- * @exception E_FILE_NOT_FOUND The corresponding format file is not found.
+ * @exception E_FILE_NOT_FOUND The file with the corresponding format is not found.
* @exception E_INVALID_ARG The specified @c format is invalid.
- * @see AddAttachment()
- * @see GetAttachment()
+ * @see AddAttachment()
+ * @see GetAttachment()
*/
result RemoveAttachment(MmsAttachmentFormat format);
class _PushManagerImpl;
/**
-* @class PushManager
-* @brief This class provides methods to use the push messaging service.
-*
-* @since 2.0
-*
-* @remarks If an application package contains multiple applications, only one application can use the push messaging service at a time.
-*
-* @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
-*
-*
-* The %PushManager class provides methods to register, unregister, and use the push messaging service.
-*
-* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
-*
-* @see Tizen::Shell::NotificationManager
-*
-* The following example demonstrates how to use the %PushManager class.
-*
-* @code
-*
+ * @class PushManager
+ * @brief This class provides methods to use the push messaging service.
+ *
+ * @since 2.0
+ *
+ * @remarks If an application package contains multiple applications, only one application can use the push messaging service at a time.
+ *
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ *
+ *
+ * The %PushManager class provides methods to register, unregister, and use the push messaging service.
+ *
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
+ *
+ * @see Tizen::Shell::NotificationManager
+ *
+ * The following example demonstrates how to use the %PushManager class.
+ *
+ * @code
+ *
#include <FBase.h>
#include <FMessaging.h>
: public Tizen::Base::Object
{
public:
- /**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
- *
- * @since 2.0
- */
+ /**
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the Construct() method must be called right after calling this constructor.
+ *
+ * @since 2.0
+ */
PushManager(void);
- /**
- * This destructor overrides Tizen::Base::Object::~Object().
- *
- * @since 2.0
- */
+ /**
+ * This destructor overrides Tizen::Base::Object::~Object().
+ *
+ * @since 2.0
+ */
virtual ~PushManager(void);
public:
- /**
- * Initializes this instance of the %PushManager class with the specified parameters.
+ /**
+ * Initializes this instance of %PushManager with the specified parameters.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/push
*
- * @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
* @feature %http://tizen.org/feature/network.push
* @return An error code
- * @param[in] managerListener A listener that receives the result of the %PushManager
- * class asynchronous methods
- * @param[in] eventListener A listener that receives the incoming push messages
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] managerListener The listener to receive the result of the %PushManager
+ * class asynchronous methods
+ * @param[in] eventListener The listener to receive the incoming push messages
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
- * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
- * @remarks Before calling this method, check whether the feature is supported by
- * Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
- * @see IPushManagerListener
- * @see IPushEventListener
+ * For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
+ * @remarks Before calling this method, check whether the feature is supported by
+ * Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
*/
result Construct(IPushManagerListener& managerListener, IPushEventListener& eventListener);
- /**
+ /**
* Registers the push messaging service for the current application. @n
* The %RegisterPushService() method is asynchronous.
*
* @privlevel public
* @privilege %http://tizen.org/privilege/push
*
- * @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
*
* @return An error code
- * @param[out] reqId The request ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @param[out] reqId The request ID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @see IPushManagerListener::OnPushServiceRegistered()
*/
result RegisterPushService(RequestId& reqId);
- /**
+ /**
* Unregisters the push messaging service for the current application. @n
* The %UnregisterPushService() method is asynchronous.
*
* @privlevel public
* @privilege %http://tizen.org/privilege/push
*
- * @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
*
* @return An error code
- * @param[out] reqId The request ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @param[out] reqId The request ID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @see IPushManagerListener::OnPushServiceUnregistered()
*/
result UnregisterPushService(RequestId& reqId);
- /**
- * Checks whether the push messaging service registration has been completed for the current application.
+ /**
+ * Checks whether the push messaging service is registered for the current application.
*
* @since 2.0
*
- * @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
*
* @return @c true if the registration is completed, @n
* else @c false
*/
bool IsPushServiceRegistered(void) const;
- /**
+ /**
* Gets the unread push messages. @n
* If an application receives unread messages with the %GetUnreadMessagesN() method, the messages are removed from the system.
*
* @privlevel public
* @privilege %http://tizen.org/privilege/push
*
- * @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
*
* @return A pointer to the list that contains unread push messages
- * @exception E_SUCCESS The method is successful.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks
* - The specific error code can be accessed using the GetLastResult() method.
- * - If the user launches the application using a ticker or a quick panel,
- * the push message related to the notification is delivered to the application
- * as a launch argument.
- * - The launch arguments are the input parameters for
- * Tizen::App::IAppControlProviderEventListener::OnAppControlRequestReceivedN().
- * - This method returns all the unread messages including the message
- * delivered as a launch argument.
- * @see Tizen::App::IAppControlProviderEventListener
+ * - If the user launches the application using a ticker or a quick panel, the push message related to the
+ * notification is delivered to the application as a launch argument.
+ * - The launch arguments are the input parameters for Tizen::App::IAppControlProviderEventListener::OnAppControlRequestReceivedN().
+ * - This method returns all the unread messages including the message delivered as a launch argument.
+ * @see Tizen::App::IAppControlProviderEventListener
*/
Tizen::Base::Collection::IList* GetUnreadMessagesN(void);
- /**
- * Sends the push message to a single recipient. @n
+ /**
+ * Sends the specified push message to a single recipient. @n
* The %SendPushMessage() method is asynchronous.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/push and %http://tizen.org/privilege/http @n
- * Both privileges are required.
+ * Both the privileges are required.
*
- * @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
*
* @return An error code
- * @param[in] message The push message
- * @param[in] registrationId The registration ID of the recipient
- * @param[in] appSecret The secret code of the application issued by the push server to authenticate the application
- * @param[out] reqId The request ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
- * @see IPushManagerListener::OnPushMessageSent()
+ * @param[in] message The push message
+ * @param[in] registrationId The registration ID of the recipient
+ * @param[in] appSecret The secret code of the application issued by the push server to authenticate the application
+ * @param[out] reqId The request ID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
+ * @see IPushManagerListener::OnPushMessageSent()
*/
result SendPushMessage(const PushMessage& message, const Tizen::Base::String& registrationId, const Tizen::Base::String& appSecret, RequestId& reqId);
- /**
- * Sends the push message to multiple recipients. @n
+ /**
+ * Sends the specified push message to multiple recipients. @n
* The %SendPushMessage() method is asynchronous.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/push and %http://tizen.org/privilege/http @n
- * Both privileges are required.
+ * Both the privileges are required.
*
- * @pre In order to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
+ * @pre For information on how to use the push messaging service, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/push_messaging.htm">Push Messaging Guide</a>.
*
* @return An error code
- * @param[in] message The push message
- * @param[in] registrationIdList The list of registration IDs of the recipients
- * @param[in] appSecret The secret code of the application issued by the push server to authenticate the application
- * @param[out] reqId The request ID
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG A specified input parameter is invalid.
- * @exception E_MAX_EXCEEDED The number of registration IDs has crossed the maximum limit.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
- * @remarks The maximum limit can be checked by using GetMaxRecipientCount().
- * @see IPushManagerListener::OnPushMessageSent()
+ * @param[in] message The push message
+ * @param[in] registrationIdList The list of registration IDs of the recipients
+ * @param[in] appSecret The secret code of the application issued by the push server to authenticate the application
+ * @param[out] reqId The request ID
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG A specified input parameter is invalid.
+ * @exception E_MAX_EXCEEDED The number of registration IDs has crossed the maximum limit.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
+ * @remarks The maximum limit can be checked by using GetMaxRecipientCount().
+ * @see IPushManagerListener::OnPushMessageSent()
*/
result SendPushMessage(const PushMessage& message, const Tizen::Base::Collection::IList& registrationIdList, const Tizen::Base::String& appSecret, RequestId& reqId);
/**
- * Gets the maximum number of recipients sent by a multiple SendPushMessage() method.
+ * Gets the maximum number of recipients for push messages sent by the multiple SendPushMessage() method.
*
* @since 2.0
*
class _PushMessageImpl;
/**
-* @class PushMessage
-* @brief This class provides methods for handling a push message.
-*
-* @since 2.0
-*
-* The %PushMessage class provides methods for handling a push message. It allows you to get the body text and
-* the received time of a push message.
-*
-* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
-*/
+ * @class PushMessage
+ * @brief This class provides methods for handling a push message.
+ *
+ * @since 2.0
+ *
+ * The %PushMessage class provides methods for handling a push message. It allows the user to get the body text and
+ * the received time of a push message.
+ *
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
+ */
class _OSP_EXPORT_ PushMessage
: public Tizen::Base::Object
{
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
PushMessage(void);
- /**
- * This destructor overrides Tizen::Base::Object::~Object().
- *
- * @since 2.0
- */
+ /**
+ * This destructor overrides Tizen::Base::Object::~Object().
+ *
+ * @since 2.0
+ */
virtual ~PushMessage(void);
public:
- /**
- * Gets the date and time (UTC time) of the message when it is received.
+ /**
+ * Gets the date and time (UTC time) of a message when it is received.
*
* @since 2.0
*
*/
Tizen::Base::DateTime GetReceivedTime(void) const;
- /**
+ /**
* @if OSPDEPREC
- * Gets the body of the message.
+ * Gets the body of a message.
*
* @brief <i> [Deprecated] </i>
* @deprecated This method is deprecated. Instead of using this method, use the Tizen::Shell::NotificationRequest::GetAppMessage() method.
*/
Tizen::Base::String GetText(void) const;
- /**
- * Sets an action of the push message.
+ /**
+ * Sets the specified action of a push message.
*
* @since 2.0
*
* @return An error code
- * @param[in] action An action of the push message
+ * @param[in] action The action of the push message
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result SetAction(PushAction action);
- /**
- * Gets an action of the push message.
+ /**
+ * Gets the action of the push message.
*
* @since 2.0
*
- * @return An action of the push message
+ * @return The action of the push message
*/
PushAction GetAction(void) const;
- /**
- * Sets the notification of the push message.
+ /**
+ * Sets the specified notification of a push message.
*
* @since 2.0
*
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @remarks PushMessage supports to set only alert text of NotificationRequest instance, and others are ignored.
- * @see Tizen::Shell::NotificationRequest
+ * @remarks PushMessage only supports setting the alert text of the NotificationRequest instance, and ignores others.
*/
result SetNotification(const Tizen::Shell::NotificationRequest& notificationRequest);
- /**
+ /**
* Gets the notification of the push message.
*
* @since 2.0
*
* @return The notification request
- * @remarks PushMessage supports to get only alert text of NotificationRequest instance, and others are ignored.
- * @see Tizen::Shell::NotificationRequest
+ * @remarks PushMessage only supports getting the alert text of the NotificationRequest instance, and ignores others.
*/
Tizen::Shell::NotificationRequest GetNotification(void) const;
- /**
+ /**
* Copying of objects using this copy constructor is allowed.
*
* @since 2.0
*
- * @param[in] rhs An instance of %PushMessage
+ * @param[in] rhs An instance of %PushMessage to copy
*/
PushMessage(const PushMessage& rhs);
- /**
+ /**
* Copying of objects using this copy assignment operator is allowed.
*
* @since 2.0
*
* @return A reference to this instance
- * @param[in] rhs An instance of %PushMessage
+ * @param[in] rhs An instance of %PushMessage to copy
*/
PushMessage& operator =(const PushMessage& rhs);
- /**
- * Compares the specified instance of %PushMessage with the calling instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if the values match, @n
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %PushMessage instance, @n
* else @c false
* @param[in] obj The other Tizen::Base::Object to compare
* @see Tizen::Base::Object::Equals()
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
// forward declaration
class _RecipientListImpl;
- /**
+ /**
* @class RecipientList
* @brief This class provides the abstract data type and methods for handling recipients.
*
* @since 2.0
*
- * The %RecipientList class provides methods for handling message recipients. It allows you to add, remove, set,
- * and get the list of recipients. A recipient is an email address for an email message and a telephone number
- * for an SMS or MMS message.
+ * The %RecipientList class provides methods for handling message recipients. It allows the user to add, remove, set,
+ * and get the list of recipients. A recipient is an email address for an email message or a telephone number
+ * for an SMS or MMS message.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
-
+ *
*/
class _OSP_EXPORT_ RecipientList
: public Tizen::Base::Object
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
RecipientList(void);
- /**
+ /**
* This is the copy constructor for the %RecipientList class.
*
* @since 2.0
*
- * @param[in] value An instance of %RecipientList
+ * @param[in] value An instance of %RecipientList to copy
*/
RecipientList(const RecipientList& value);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
//Operator
public:
- /**
+ /**
* This is the assignment operator for this class. @n
- * Copies the recipient list from the specified instance of %RecipientList to the calling instance of %RecipientList.
+ * Copies the recipient list from the specified instance of %RecipientList to the current instance of %RecipientList.
*
* @since 2.0
*
- * @param[in] rhs A reference to the %RecipientList instance
+ * @param[in] rhs A reference to the %RecipientList instance to copy
*/
RecipientList& operator =(const RecipientList& rhs);
- /**
+ /**
* This operator compares the two recipient lists.
*
* @since 2.0
*
- * @return @c true if both instances are equal, @n
- * else @c false
+ * @return @c true if both the instances are equal, @n
+ * else @c false
* @param[in] rhs A reference to the %RecipientList instance on the right-hand side of the operator
*/
bool operator ==(const RecipientList& rhs) const;
- /**
- * This operator compares the specified instance with the calling instance for inequality.
+ /**
+ * This operator compares the specified instance with the current instance for inequality.
*
* @since 2.0
*
- * @return @c true if both instances are not equal, @n
- * else @c false
- * @param[in] rhs A reference to the %RecipientList instance on the right-hand side of the operator
+ * @return @c true if both the instances are not equal, @n
+ * else @c false
+ * @param[in] rhs A reference to the %RecipientList instance on the right-hand side of the operator
*/
bool operator !=(const RecipientList& rhs) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
*
* @return The hash value of the current instance
* @remarks
- * - Two equal instances should return the same hash value.
- * - For better performance, the used hash function must generate a random distribution for all inputs.
+ * - Two equal instances should return the same hash value.
+ * - For better performance, the hash function must generate a random distribution for all the inputs.
*/
virtual int GetHashCode(void) const;
// Operation
public:
- /**
- * Compares the specified instance with the calling instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if both instances are equal, @n
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %RecipientList instance, @n
* else @c false
* @param[in] value An instance of %RecipientList
*/
virtual bool Equals(const Tizen::Base::Object& value) const;
- /**
- * Adds a recipient string.
+ /**
+ * Adds the specified recipient string.
*
* @since 2.0
*
* @return An error code
- * @param[in] type The type of recipient
+ * @param[in] type The recipient type
* @param[in] recipient The recipient string
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OBJ_ALREADY_EXIST The specified @c recipient is already added.
- * @exception E_INVALID_ARG The specified @c recipient string length is too short (< 3) or too long (> 320), or
- * the specified @c type is invalid.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c recipient string length is too short (< 3) or too long (> 320).
+ * - The specified @c type is invalid.
* @remarks
- * - The limit of the number of recipients is not checked in this method. This is done in the SmsManager::Send(),
- * MmsManager::Send(), and EmailManager::Send() methods.
- * - The minimum length of a recipient is @c 3 for a phone number and @c 5 for an email address.
- * - The maximum length of a recipient is @c 41 for a phone number and @c 320 for an email address.
- * @see Set()
- * @see GetListN()
- * @see SmsManager::Send()
- * @see MmsManager::Send()
- * @see EmailManager::Send()
+ * - The limit of the number of recipients is not checked in this method. This is done in the SmsManager::Send(),
+ * MmsManager::Send(), and EmailManager::Send() methods.
+ * - The minimum length of a recipient is @c 3 for a phone number and @c 5 for an email address.
+ * - The maximum length of a recipient is @c 41 for a phone number and @c 320 for an email address.
+ * @see Set()
+ * @see GetListN()
*/
result Add(RecipientType type, const Tizen::Base::String& recipient);
- /**
- * Removes the recipient.
+ /**
+ * Removes the specified recipient.
*
* @since 2.0
*
- * @return An error code
- * @param[in] type The type of recipient
+ * @return An error code
+ * @param[in] type The recipient type
* @param[in] recipient The recipient string
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c recipient string length is too short (< 3) or too long (> 320), or
- * the specified @c type is invalid.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c recipient string length is too short (< 3) or too long (> 320).
+ * - The specified @c type is invalid.
* @exception E_OBJ_NOT_FOUND The specified @c recipient does not exist.
* @see Add()
*/
result Remove(RecipientType type, const Tizen::Base::String& recipient);
- /**
- * Sets a recipient list.
+ /**
+ * Sets the specified recipient list.
*
* @since 2.0
*
- * @return An error code
- * @param[in] type The type of recipient
- * @param[in] list A list of recipient strings
+ * @return An error code
+ * @param[in] type The recipient type
+ * @param[in] list The list of recipient strings
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The length of one of the recipients in the list is too short (< 3) or too long (> 320), or
- * the specified @c type is invalid.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The length of one of the recipients in the list is too short (< 3) or too long (> 320).
+ * - The specified @c type is invalid.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_ALREADY_EXIST A duplicate recipient in the recipient list already exists.
- * @remarks
- * - The limit of recipients is not checked in this method.
- * - This is done in the SmsManager::Send(), MmsManager::Send(), and EmailManager::Send() methods.
+ * @exception E_OBJ_ALREADY_EXIST A duplicate recipient exists in the recipient list.
+ * @remarks The limit of the recipients is not checked in this method.
+ * This is done in the SmsManager::Send(), MmsManager::Send(), and EmailManager::Send() methods.
* @see Add()
* @see GetListN()
*/
result Set(RecipientType type, const Tizen::Base::Collection::IList& list);
- /**
- * Gets the recipient list of the specific recipient type.
+ /**
+ * Gets the recipient list of the specified recipient type.
*
* @since 2.0
*
- * @return A pointer to the list of recipient type
- * @param[in] type The type of recipient
+ * @return A pointer to the list of recipient type
+ * @param[in] type The recipient type
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_INVALID_ARG The specified @c type is invalid.
* @remarks
- * - The recipient is an email address for an email message or a telephone number for an SMS or MMS message.
- * - The specified @c type contains @c RECIPIENT_TYPE_TO, @c RECIPIENT_TYPE_CC, @c RECIPIENT_TYPE_BCC. @n
- * - The specific error code can be accessed using the GetLastResult() method.
- * @see Add()
- * @see Set()
+ * - The recipient is an email address for an email message or a telephone number for an SMS or MMS message.
+ * - The specified @c type contains @c RECIPIENT_TYPE_TO, @c RECIPIENT_TYPE_CC or @c RECIPIENT_TYPE_BCC.
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * @see Add()
+ * @see Set()
*/
Tizen::Base::Collection::IList* GetListN(RecipientType type) const;
// limitations under the License.
//
/**
- * @file FMsgSmsManager.h
+ * @file FMsgSmsManager.h
* @brief This is the header file for the %SmsManager class.
*
* This header file contains the declarations of the %SmsManager class.
// forward declaration
class _SmsManagerImpl;
- /**
+ /**
* @class SmsManager
- * @brief This class provides methods to use the SMS messaging service.
+ * @brief This class provides methods to use the Short Message Service.
*
- * @since 2.0
+ * @since 2.0
*
* The %SmsManager class is used to send, receive, and retrieve SMS messages.
*
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
SmsManager(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
// Operation
public:
- /**
+ /**
* Initializes this instance of %SmsManager with the specified parameter.
*
* @since 2.0
*
* @feature %http://tizen.org/feature/network.telephony
* @return An error code
- * @param[in] listener The listener to receive a send result asynchronously
+ * @param[in] listener The listener to receive a sent result asynchronously
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
*/
result Construct(ISmsListener& listener);
- /**
- * Adds the event listener for receiving SMS messages.
+ /**
+ * Adds the specified event listener for receiving SMS messages.
*
* @since 2.0
* @privlevel partner
* @privilege %http://tizen.org/privilege/smstrigger
*
* @return An error code
- * @param[in] port A port number
+ * @param[in] port The port number
* @param[in] eventListener The listener to receive SMS messages
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_OBJ_ALREADY_EXIST The specified port number is already registered. @n
- * The listener is already exists.
+ * @exception E_OBJ_ALREADY_EXIST Either of the following conditions has occurred:
+ * - The specified port number is already registered.
+ * - The listener already exists.
* @exception E_FAILURE The specified port number is already used in other applications.
* @exception E_INVALID_ARG The specified @c port is invalid. @n
- * The port number must range from @c 1 to @c 9999 (1 <= port <= 9999).
+ * The port number ranges from @c 1 to @c 9999 (1 <= port <= 9999).
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @see ISmsEventListener
- * @see RemoveSmsEventListener()
+ * @see RemoveSmsEventListener()
*/
result AddSmsEventListener(int port, ISmsEventListener& eventListener);
- /**
- * Removes the event listener for receiving SMS messages.
+ /**
+ * Removes the specified event listener for receiving SMS messages.
*
* @since 2.0
* @privlevel partner
* @privilege %http://tizen.org/privilege/smstrigger
*
* @return An error code
- * @param[in] port A port number
+ * @param[in] port The port number
* @param[in] eventListener The listener to receive SMS messages
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OBJ_NOT_FOUND The listener is not found.
* @exception E_SYSTEM A system error has occurred.
* @exception E_INVALID_ARG The specified @c port is invalid. @n
- * The port number must range from @c 1 to @c 9999 (1 <= port <= 9999).
+ * The port number ranges from @c 1 to @c 9999 (1 <= port <= 9999).
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @see ISmsEventListener
- * @see AddSmsEventListener()
+ * @see AddSmsEventListener()
*/
result RemoveSmsEventListener(int port, ISmsEventListener& eventListener);
- /**
- * Adds the event listener for receiving SMS messages.
+ /**
+ * Adds the specified event listener for receiving SMS messages.
*
* @since 2.0
* @privlevel public
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @exception E_OBJ_ALREADY_EXIST The listener already exists.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
- * @see ISmsMessageEventListener
- * @see RemoveSmsMessageEventListener()
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
+ * @see RemoveSmsMessageEventListener()
*/
result AddSmsMessageEventListener(ISmsMessageEventListener& eventListener);
- /**
- * Removes the event listener for receiving SMS messages.
+ /**
+ * Removes the specified event listener for receiving SMS messages.
*
* @since 2.0
* @privlevel public
* @exception E_OBJ_NOT_FOUND The listener is not found.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
- * @see ISmsMessageEventListener
- * @see AddSmsMessageEventListener()
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
+ * @see AddSmsMessageEventListener()
*/
result RemoveSmsMessageEventListener(ISmsMessageEventListener& eventListener);
- /**
- * Sends the SMS message.
+ /**
+ * Sends the specified SMS message.
*
* @since 2.0
* @privlevel public
* @exception E_INVALID_ARG The number of recipients is @c 0.
* @exception E_MAX_EXCEEDED The number of recipients has crossed the maximum limit (Maximum 10).
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
- * @remarks The CC and BCC recipients in the @c recipientList are ignored when sending an SMS message.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
+ * @remarks The CC and BCC recipients in the @c recipientList are ignored while sending an SMS message.
* @see ISmsListener::OnSmsMessageSent()
*/
result Send(const SmsMessage& message, const RecipientList& recipientList, bool saveToSentbox);
- /**
+ /**
* Gets the total number of SMS messages in the specified message box.
*
* @since 2.0
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
* @return The total number of SMS messages in the specified message box
- * @param[in] type The type of message box
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c type is invalid.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @param[in] type The message box type
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified @c type is invalid.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks
- * - In case of an error, this method returns the negative value. For example, @c -1.
+ * - In case of an error, this method returns a negative value. For example, @c -1.
* - The specific error code can be accessed using the GetLastResult() method.
*/
int GetTotalMessageCount(SmsMessageBoxType type) const;
- /**
- * Searches the SMS messages by keyword and|or sender address in the Inbox.
+ /**
+ * Searches the SMS messages by keyword and/or sender address in the Inbox.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/messaging.read @n
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
- * @return A pointer to the list of the SmsMessage class instances
- * @param[in] pKeyword A part of the body text as a keyword (partial match) @n
- * In case of @c null or an empty string, this method searches all SMS messages in the Inbox regardless of the keyword.
+ * @return A pointer to the list of SmsMessage instances
+ * @param[in] pKeyword A part of the body text as a keyword (partial match) @n
+ * In case of @c null or an empty string, this method searches all the SMS messages in the Inbox regardless of the keyword.
* @param[in] pSenderAddress A telephone number as a sender address (exact match) @n
- * In case of @c null or an empty string, this method searches all SMS messages in the Inbox regardless of the sender address.
- * @param[in] startIndex The start index (base 0)
+ * In case of @c null or an empty string, this method searches all the SMS messages in the Inbox regardless of the sender address.
+ * @param[in] startIndex The starting index (base 0)
* @param[in] count The count of SMS messages to search
- * @param[out] totalResultCount The total count of the searched result
+ * @param[out] totalResultCount The total count of the searched result
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c pKeyword string length is less than @c 2 or greater than @c 30. @n
- * - The specified @c pSenderAddress string length is less than @c 3 or greater than @c 41. @n
- * - The specified @c startIndex value is less than @c 0. @n
- * - The specified @c count value is less than @c 0 or greater than @c 20.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c pKeyword string length is less than @c 2.
+ * - The specified @c pKeyword string length is greater than @c 30.
+ * - The specified @c pSenderAddress string length is less than @c 3.
+ * - The specified @c pSenderAddress string length is greater than @c 41.
+ * - The specified @c startIndex value is less than @c 0.
+ * - The specified @c count value is less than @c 0.
+ * - The specified @c count value is greater than @c 20.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks
* - The specific error code can be accessed using the GetLastResult() method.
- * - The search with the specified keywords searches using only the first 50 characters of the body text.
+ * - The search with the specified keywords uses only the first 50 characters of the body text.
* - The SMS messages in the searched result contain only @c 160 bytes for the body text.
- * - To check whether there is additional text, use the SmsMessage::HasMoreText() method. @n
+ * - To check whether there is additional text, use the SmsMessage::HasMoreText() method.
* - To get the full body text, use GetFullText() with its message ID.
- * @see SmsMessage
- * @see GetFullText()
+ * @see GetFullText()
*/
Tizen::Base::Collection::IList* SearchInboxN(const Tizen::Base::String* pKeyword, const Tizen::Base::String* pSenderAddress, int startIndex, int count, int& totalResultCount) const;
- /**
+ /**
* Searches the SMS messages by keyword in the specified message box.
*
* @since 2.0
* @privilege %http://tizen.org/privilege/messaging.read @n
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
- * @return A pointer to the list of the SmsMessage class instances
- * @param[in] type The type of message box
- * @param[in] pKeyword A part of the body text as a keyword (partial match) @n
- * In case of @c null or an empty string, this method searches all SMS messages in the specified message box.
- * @param[in] startIndex The start index (base 0)
+ * @return A pointer to the list of SmsMessage instances
+ * @param[in] type The type of message box
+ * @param[in] pKeyword A part of the body text as a keyword (partial match) @n
+ * In case of @c null or an empty string, this method searches all the SMS messages in the specified message box.
+ * @param[in] startIndex The start index (base 0)
* @param[in] count The count of SMS messages to search
- * @param[out] totalResultCount The total count of the searched result
+ * @param[out] totalResultCount The total count of the searched result
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c type is invalid. @n
- * - The specified @c pKeyword string length is less than @c 2 or greater than @c 30. @n
- * - The specified @c startIndex value is less than @c 0. @n
- * - The specified @c count value is less than @c 0 or greater than @c 20.
- * @exception E_OUT_OF_MEMORY The memory is insufficient.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c type is invalid.
+ * - The specified @c pKeyword string length is less than @c 2.
+ * - The specified @c pKeyword string length is greater than @c 30.
+ * - The specified @c startIndex value is less than @c 0.
+ * - The specified @c count value is less than @c 0.
+ * - The specified @c count value is greater than @c 20.
+ * @exception E_OUT_OF_MEMORY The memory is insufficient.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks
- * - The specific error code can be accessed using the GetLastResult() method.
- * - The search with the specified keywords searches using only the first 50 characters of the body text.
- * - The SMS messages in the searched result contain only @c 160 bytes for the body text.
- * - To check whether there is additional text, use the SmsMessage::HasMoreText() method.
- * - To get the full body text, use the GetFullText() method with its message ID.
- * @see SmsMessage
+ * - The specific error code can be accessed using the GetLastResult() method.
+ * - The search with the specified keywords uses only the first 50 characters of the body text.
+ * - The SMS messages in the searched result contain only @c 160 bytes for the body text.
+ * - To check whether there is additional text, use the SmsMessage::HasMoreText() method.
+ * - To get the full body text, use the GetFullText() method with the message ID.
* @see GetFullText()
*/
Tizen::Base::Collection::IList* SearchMessageBoxN(SmsMessageBoxType type, const Tizen::Base::String* pKeyword, int startIndex, int count, int& totalResultCount) const;
- /**
+ /**
* Gets the full text of the SMS message in the message box using the message ID.
*
* @since 2.0
* @privilege %http://tizen.org/privilege/messaging.read @n
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
- * @return The full text of the specified SMS message @n
- * The value is an empty string in case of an error.
- * @param[in] messageId The unique ID of the message
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c messageId is invalid, or it must be greater than or equal to @c 0.
- * @exception E_OBJ_NOT_FOUND The SMS message with the specified @c messageId is not found.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
- * @remarks The specific error code can be accessed using the GetLastResult() method.
+ * @return The full text of the specified SMS message, @n
+ * else an empty string if an error occurs
+ * @param[in] messageId The unique ID of the message
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c messageId is invalid.
+ * - The specified @c messageId is greater than or equal to @c 0.
+ * @exception E_OBJ_NOT_FOUND The SMS message with the specified @c messageId is not found.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
+ * @remarks The specific error code can be accessed using the GetLastResult() method.
* @see SmsMessage::HasMoreText()
*/
Tizen::Base::String GetFullText(int messageId) const;
- /**
- * Sets the event listener for receiving CB messages.
+ /**
+ * Sets the specified event listener for receiving CB messages.
*
* @since 2.0
* @privlevel platform
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by
+ * @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
- * @see ICbsMessageEventListener
*/
result SetCbsMessageEventListener(ICbsMessageEventListener* pListener);
- /**
- * Sets the event listener for receiving ETWS primary notification.
+ /**
+ * Sets the specified event listener for receiving ETWS primary notifications.
*
* @since 2.0
* @privlevel platform
*
* @feature %http://tizen.org/feature/network.telephony.sms.cbs
* @return An error code
- * @param[in] pListener The listener to receive ETWS primary notification
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] pListener The listener to receive ETWS primary notifications
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by
+ * @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
- * @see IEtwsPrimaryNotificationEventListener
*/
result SetEtwsPrimaryNotificationEventListener(IEtwsPrimaryNotificationEventListener* pListener);
- /**
- * Enables or disables the save option for CBS message to the CbsBox.
+ /**
+ * Enables or disables the save option for a CBS message to the CbsBox.
*
* @since 2.0
* @privlevel platform
*
* @feature %http://tizen.org/feature/network.telephony.sms.cbs
* @return An error code
- * @param[in] enable Set to @c true to save the message in the CbsBox, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] enable Set to @c true to save the message in the CbsBox, @n
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by
+ * @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
*/
result SetSavingToCbsBoxEnabled(bool enable);
- /**
+ /**
* Checks whether the CB service is enabled.
*
* @since 2.0
*/
bool IsCbsEnabled(void) const;
- /**
+ /**
* Enables or disables the CB service.
*
* @since 2.0
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by
+ * @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* @see IsCbsEnabled()
*/
result SetCbsEnabled(bool enable);
- /**
- * Adds a CBS channel with specified parameters.
+ /**
+ * Adds the CBS channel with the specified parameters.
*
* @since 2.0
* @privlevel platform
* @return An error code
* @param[in] from The starting index of the message ID of the channel
* @param[in] to The last index of the message ID of the channel
- * @param[in] name The name of the channel. (can be an empty string)
+ * @param[in] name The name of the channel. @n
+ * This can be an empty string.
* @param[in] activate Set to @c true to activate the channel, @n
* else @c false.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c to parameter is smaller than @c from. @n
- * - The specified @c to or @c from parameter is a negative value. @n
- * - The specified @c to parameter exceeds the limit (0xFFFF). @n
- * - The range (@c to - @c from) exceeds the limit (0xFFFF).
- * - The specified @c name string length is greater than @c 32. @n
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c to is smaller than @c from.
+ * - The specified @c to or @c from is negative.
+ * - The specified @c to exceeds the limit (0xFFFF).
+ * - The range (@c to - @c from) exceeds the limit (0xFFFF).
+ * - The specified @c name string length is greater than @c 32.
* @exception E_ALREADY_SET The channel range (@c from ~ @c to) is already set.
* @exception E_ILLEGAL_ACCESS The application does not have the permission to add the CBS channel.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by
+ * @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* @see RemoveCbsChannel()
*/
result AddCbsChannel(int from, int to, Tizen::Base::String& name, bool activate = true);
- /**
- * Removes a CBS channel.
+ /**
+ * Removes the CBS channel with the specified parameters.
*
* @since 2.0
* @privlevel platform
* @param[in] from The starting index of the message ID of the channel
* @param[in] to The last index of the message ID of the channel
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c to parameter is smaller than @c from. @n
- * - The specified @c to or @c from parameter is a negative value. @n
- * - The specified @c to parameter exceeds the limit (0xFFFF). @n
- * - The range (@c to - @c from) exceeds the limit (0xFFFF).
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c to is smaller than @c from.
+ * - The specified @c to or @c from is negative.
+ * - The specified @c to exceeds the limit (0xFFFF).
+ * - The range (@c to - @c from) exceeds the limit (0xFFFF).
* @exception E_OBJ_NOT_FOUND The channel range (@c from ~ @c to) is not found.
* @exception E_ILLEGAL_ACCESS The application does not have the permission to remove the CBS channel.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by
+ * @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* @see AddCbsChannel()
*/
result RemoveCbsChannel(int from, int to);
- /**
- * Gets a CBS channel with specified range.
+ /**
+ * Gets the CBS channel with the specified range.
*
* @since 2.0
* @privlevel platform
* @privilege %http://tizen.org/privilege/cellbroadcast
*
* @feature %http://tizen.org/feature/network.telephony.sms.cbs
- * @return A pointer to the CBS channel with specific range.
+ * @return A pointer to the CBS channel with the specified range
* @param[in] from The starting index of the message ID of the channel
* @param[in] to The last index of the message ID of the channel
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG Either of the following conditions has occurred: @n
- * - The specified @c to parameter is smaller than @c from. @n
- * - The specified @c to or @c from parameter is a negative value. @n
- * - The specified @c to parameter exceeds the limit (0xFFFF). @n
- * - The range (@c to - @c from) exceeds the limit (0xFFFF).
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c to is smaller than @c from.
+ * - The specified @c to or @c from is negative.
+ * - The specified @c to exceeds the limit (0xFFFF).
+ * - The range (@c to - @c from) exceeds the limit (0xFFFF).
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
* @remarks
- * - Before calling this method, check whether the feature is supported by
+ * - Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* - The specific error code can be accessed using the GetLastResult() method.
- * @see AddCbsChannel()
- * @see RemoveCbsChannel()
+ * @see AddCbsChannel()
+ * @see RemoveCbsChannel()
*/
CbsChannel* GetCbsChannelN(int from, int to) const;
- /**
+ /**
* Gets the CBS channel list.
*
* @since 2.0
*
* @feature %http://tizen.org/feature/network.telephony.sms.cbs
*
- * @return A pointer to the list of CBS channel
+ * @return A pointer to the list of CBS channels
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
* @remarks
- * - Before calling this method, check whether the feature is supported by
+ * - Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* - The specific error code can be accessed using the GetLastResult() method.
- * @see AddCbsChannel()
- * @see RemoveCbsChannel()
- * @see CbsChannel
+ * @see AddCbsChannel()
+ * @see RemoveCbsChannel()
+ * @see CbsChannel
*/
Tizen::Base::Collection::IList* GetCbsChannelListN(void);
class _SmsMessageImpl;
class RecipientList;
- /**
+ /**
* @class SmsMessage
* @brief This class provides methods for handling an SMS message.
*
* @since 2.0
*
- * The %SmsMessage class provides methods for handling SMS messages. It allows you to set and get the body text of an SMS message.
+ * The %SmsMessage class provides methods for handling SMS messages. It allows the user to set and get the body text of an SMS message.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/messaging/messaging.htm">Messaging Guide</a>.
*/
{
// Life cycle
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
SmsMessage(void);
- /**
+ /**
* This is the destructor for this class.
*
* @since 2.0
*/
virtual ~SmsMessage(void);
- /**
+ /**
* This is the copy constructor for the %SmsMessage class.
*
* @since 2.0
*
- * @param[in] value An instance of %SmsMessage
+ * @param[in] value An instance of %SmsMessage to copy
*/
SmsMessage(const SmsMessage& value);
public:
- /**
- * This assignment operator copies an SMS message from the specified instance of %SmsMessage to the calling instance of %SmsMessage.
+ /**
+ * This assignment operator copies an SMS message from the specified instance of %SmsMessage to the current instance of %SmsMessage.
*
* @since 2.0
*
- * @return A reference to the %SmsMessage instance
+ * @return A reference to the %SmsMessage instance
* @param[in] rhs A reference to the %SmsMessage instance to copy
*/
SmsMessage& operator =(const SmsMessage& rhs);
- /**
- * Compares the calling instance with the specified instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if the specified instance of Tizen::Base::Object is equal to the calling %SmsMessage instance, @n
- * else @c false
- * @param[in] obj The object to compare
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %SmsMessage instance, @n
+ * else @c false
+ * @param[in] obj The object to compare
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
*
- * @return The hash value of the current instance
+ * @return The hash value of the current instance
*/
virtual int GetHashCode(void) const;
// Operation
public:
- /**
- * Sets the body of the SMS message.
+ /**
+ * Sets the body of an SMS message.
*
* @since 2.0
*
- * @return An error code
+ * @return An error code
* @param[in] text The body of the SMS message
* @exception E_SUCCESS The method is successful.
* @exception E_MAX_EXCEEDED The body length of the message exceeds the maximum limit (Maximum 80 characters).
*/
result SetText(const Tizen::Base::String& text);
- /**
- * Gets the body of the SMS message.
+ /**
+ * Gets the body of an SMS message.
*
* @since 2.0
*
* @return The body of the SMS message
* @remarks
- * - If the message is from the Inbox, Sentbox, or Outbox, it may contain only @c 160 bytes for the body text.
- * - To check whether the message contains more than @c 160 bytes for the body text, use the HasMoreText() method.
- * - To get the full body text, use the SmsManager::GetFullText() method with its message ID.
- * @see SetText()
- * @see HasMoreText()
- * @see GetId()
- * @see SmsManager::GetFullText()
+ * - If the message is from the Inbox, Sentbox, or Outbox, it may contain only @c 160 bytes for the body text.
+ * - To check whether the message contains more than @c 160 bytes for the body text, use the HasMoreText() method.
+ * - To get the full body text, use the SmsManager::GetFullText() method with its message ID.
+ * @see SetText()
+ * @see HasMoreText()
+ * @see GetId()
*/
Tizen::Base::String GetText(void) const;
- /**
- * Gets the sender address of the SMS message.
+ /**
+ * Gets the sender address of an SMS message.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/messaging.read @n
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
- * @return The sender address of the SMS message
+ * @return The sender address of the SMS message
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_OPERATION This operation is only allowed to the incoming message or the message from the Inbox.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - This operation is only allowed to the incoming message.
+ * - This operation is only allowed to the message from the Inbox.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::String GetSenderAddress(void) const;
- /**
- * Gets the received time of the SMS message.
+ /**
+ * Gets the received time of an SMS message.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/messaging.read @n
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
- * @return The received time of the SMS message @n
+ * @return The received time of the SMS message @n
* The value is 00:00:00, January 1, 1 in case of an error.
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_OPERATION This operation is only allowed to the incoming message or the message from the Inbox.
+ * @exception E_INVALID_OPERATION Either of the following conditions has occurred:
+ * - This operation is only allowed to the incoming message.
+ * - This operation is only allowed to the message from the Inbox.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::DateTime GetReceivedTime(void) const;
- /**
- * Gets the unique ID of the SMS message.
+ /**
+ * Gets the unique ID of an SMS message.
*
* @since 2.0
* @privlevel public
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
* @return The unique ID of the SMS message @n
- * The value is a negative value in case of an error. For example, @c -1.
+ * The value is a negative value in case of an error. For example, @c -1.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_OPERATION This operation is allowed only when the message is from the Inbox, Sentbox, or Outbox.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
int GetId(void) const;
- /**
- * Gets the sent time of the SMS message.
+ /**
+ * Gets the sent time of an SMS message.
*
* @since 2.0
* @privlevel public
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
* @return The sent time of the SMS message @n
- * The value is 00:00:00, January 1, 1 in case of an error.
+ * The value is 00:00:00, January 1, 1 in case of an error.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_OPERATION This operation is allowed only when the message is from the Sentbox or Outbox.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::DateTime GetSentTime(void) const;
- /**
- * Gets the type of the SMS message box.
+ /**
+ * Gets the type of an SMS message box.
*
* @since 2.0
* @privlevel public
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
* @return The type of the SMS message box @n
- * The value is @c SMS_MESSAGE_BOX_TYPE_NONE in case of an error.
+ * The value is @c SMS_MESSAGE_BOX_TYPE_NONE in case of an error.
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_OPERATION This operation is allowed only when the message is from the Inbox, Sentbox, or Outbox.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
SmsMessageBoxType GetMessageBoxType(void) const;
- /**
- * Gets the list of the recipients.
+ /**
+ * Gets the list of recipients.
*
* @since 2.0
* @privlevel public
* @privilege %http://tizen.org/privilege/messaging.read @n
* (%http://tizen.org/privilege/messaging.sms is deprecated.)
*
- * @return The list of the recipient
+ * @return The list of recipients
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_OPERATION This operation is allowed only when the message is from the Sentbox or Outbox.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
RecipientList GetRecipientList(void) const;
- /**
+ /**
* Checks whether the SMS message contains more than @c 160 bytes for the body text.
*
* @since 2.0
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_OPERATION This operation is allowed only when the message is from the Inbox, Sentbox, or Outbox.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
- * @exception E_USER_NOT_CONSENTED The user blocks an application from calling this method. @b Since: @b 2.1
+ * @exception E_USER_NOT_CONSENTED The user has blocked the application from calling this method. @b Since: @b 2.1
* @remarks
- * - If the return value is @c true, the SMS message contains more than @c 160 bytes for the body text.
- * - To get the full body text, use SmsManager::GetFullText().
- * - The specific error code can be accessed using the GetLastResult() method.
+ * - If the return value is @c true, the SMS message contains more than @c 160 bytes for the body text.
+ * - To get the full body text, use SmsManager::GetFullText().
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
bool HasMoreText(void) const;
//
/**
* @file FMsgTypes.h
- * @brief This is the header file for the enumerations of the Messaging namespace.
+ * @brief This is the header file for the enumerations of the %Messaging namespace.
*
* This header file contains the type declarations of the Messaging namespace.
*/
namespace Tizen { namespace Messaging
{
- /**
+ /**
* @enum RecipientType
*
* Defines the recipient type for a Short Message Service(SMS), Multimedia %Messaging Service(MMS), and email messages.
*/
enum RecipientType
{
- RECIPIENT_TYPE_TO = 0, /**<The recipient is in 'To' list */
- RECIPIENT_TYPE_CC, /**<The recipient is in 'Cc' list */
- RECIPIENT_TYPE_BCC /**<The recipient is in 'Bcc' list */
+ RECIPIENT_TYPE_TO = 0, /**< The recipient is in the 'To' list */
+ RECIPIENT_TYPE_CC, /**< The recipient is in the 'Cc' list */
+ RECIPIENT_TYPE_BCC /**< The recipient is in the 'Bcc' list */
};
- /**
+ /**
* @enum AddressType
*
* Defines the type of an address. @n
*/
enum AddressType
{
- ADDRESS_TYPE_PHONE = 0, /**<The phone number type*/
- ADDRESS_TYPE_EMAIL /**<The email type*/
+ ADDRESS_TYPE_PHONE = 0, /**< The phone number type */
+ ADDRESS_TYPE_EMAIL /**< The email type */
};
- /**
+ /**
* @enum MmsAttachmentFormat
*
* Defines the attachment type for Multimedia %Messaging Service (MMS) messages.
MMS_VCALENDAR /**< The vCalendar type */
};
- /**
+ /**
* @enum SmsMessageBoxType
*
* Defines the message box type for Short Message Service(SMS) messages.
SMS_MESSAGE_BOX_TYPE_INBOX = 0, /**< The Inbox type */
SMS_MESSAGE_BOX_TYPE_SENTBOX = 1, /**< The Sentbox type */
SMS_MESSAGE_BOX_TYPE_OUTBOX = 2, /**< The Outbox type */
- SMS_MESSAGE_BOX_TYPE_ALL = 10 /**< All message box type */
+ SMS_MESSAGE_BOX_TYPE_ALL = 10 /**< All message boxes type */
};
- /**
+ /**
* @enum EmailMessagePriority
*
* Defines the priority level for an email.
EMAIL_MESSAGE_PRIORITY_LOW = 5 /**< Low priority */
};
- /**
+ /**
* @enum PushAction
*
* Defines the push action. @n
// limitations under the License.
//
/**
-* @file FMsgWapPushManager.h
-* @brief This is the header file for the %WapPushManager class.
-*
-* This header file contains the declarations of the %WapPushManager class.
-*/
+ * @file FMsgWapPushManager.h
+ * @brief This is the header file for the %WapPushManager class.
+ *
+ * This header file contains the declarations of the %WapPushManager class.
+ */
#ifndef _FMSG_WAP_PUSH_MANAGER_H_
#define _FMSG_WAP_PUSH_MANAGER_H_
class _WapPushManagerImpl;
/**
-* @class WapPushManager
-* @brief This class provides methods to use the WAP Push messaging service.
-*
-* @since 2.0
-*
-* @final This class is not intended for extension.
-*
-* The %WapPushManager class provides methods to use the WAP Push messaging service.
-*/
+ * @class WapPushManager
+ * @brief This class provides methods to use the WAP Push messaging service.
+ *
+ * @since 2.0
+ *
+ * @final This class is not intended for extension.
+ *
+ * The %WapPushManager class provides methods to use the WAP Push messaging service.
+ */
class _OSP_EXPORT_ WapPushManager
: public Tizen::Base::Object
{
public:
- /**
+ /**
* This is the default constructor for this class.
*
* @since 2.0
*/
WapPushManager(void);
- /**
+ /**
* This destructor overrides Tizen::Base::Object::~Object().
*
* @since 2.0
virtual ~WapPushManager(void);
public:
- /**
- * Adds the event listener for receiving WAP Push messages for a specific WAP Push application ID.
+ /**
+ * Adds the event listener for receiving WAP Push messages for the specified WAP Push application ID.
*
* @since 2.0
* @privlevel platform
*
* @feature %http://tizen.org/feature/network.telephony
* @return An error code
- * @param[in] wapApplicationId The X-Wap-Application-Id indicating a WAP Push application ID
- * @param[in] listener A listener for receiving the incoming WAP Push messages
+ * @param[in] wapApplicationId The X-Wap-Application-Id that indicates the WAP Push application ID
+ * @param[in] listener The listener for receiving the incoming WAP Push messages
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_ALREADY_EXIST The specified @c wapApplicationId is already registered, or
- * the listener already exists.
+ * @exception E_OBJ_ALREADY_EXIST Either of the following conditions has occurred:
+ * - The specified @c wapApplicationId is already registered.
+ * - A listener already exists.
* @exception E_INVALID_ARG The specified @c wapApplicationId is invalid.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
* @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
- * @see IWapPushEventListener
- * @see RemoveWapPushEventListener()
+ * @see RemoveWapPushEventListener()
*/
result AddWapPushEventListener(const Tizen::Base::String& wapApplicationId, IWapPushEventListener& listener);
- /**
- * Removes the event listener for receiving WAP Push messages for a specific WAP Push application
- * ID.
+ /**
+ * Removes the event listener for receiving WAP Push messages for the specified WAP Push application ID.
*
* @since 2.0
* @privlevel platform
*
* @feature %http://tizen.org/feature/network.telephony
* @return An error code
- * @param[in] wapApplicationId The X-Wap-Application-Id indicating a WAP Push
- * application ID
- * @param[in] listener A listener for receiving the incoming WAP Push messages
+ * @param[in] wapApplicationId The X-Wap-Application-Id that indicates the WAP Push application ID
+ * @param[in] listener The listener for receiving the incoming WAP Push messages
* @exception E_SUCCESS The method is successful.
- * @exception E_OBJ_NOT_FOUND The specified @c wapApplicationId is not registered, or
- * the specified @c listener is not found.
+ * @exception E_OBJ_NOT_FOUND Either of the following conditions has occurred:
+ * - The specified @c wapApplicationId is not registered.
+ * - The specified @c listener is not found.
* @exception E_INVALID_ARG The specified @c wapApplicationId is invalid.
* @exception E_SYSTEM A system error has occurred.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
* @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
- * @see IWapPushEventListener
- * @see AddWapPushEventListener()
+ * @see AddWapPushEventListener()
*/
result RemoveWapPushEventListener(const Tizen::Base::String& wapApplicationId, IWapPushEventListener& listener);
- /**
- * Registers a condition to receive WAP Push message.
+ /**
+ * Registers a condition to receive a WAP Push message.
*
* @since 2.0
* @privlevel platform
*
* @feature %http://tizen.org/feature/network.telephony
* @return An error code
- * @param[in] wapApplicationId The X-Wap-Application-Id indicating a WAP push application ID
- * @param[in] contentType The MIME content type of the content
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c contentType or @c wapApplicationId is invalid.
- * @exception E_ILLEGAL_ACCESS The application does not have the permission to register the conditions.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] wapApplicationId The X-Wap-Application-Id that indicates the WAP push application ID
+ * @param[in] contentType The MIME content type of the content
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c contentType is invalid.
+ * - The specified @c wapApplicationId is invalid.
+ * @exception E_ILLEGAL_ACCESS The application does not have the permission to register the conditions.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @exception E_ALREADY_SET The condition is already registered.
+ * @exception E_ALREADY_SET The condition is already registered.
* @remarks Before calling this method, check whether the feature is supported by
* Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
* @see UnregisterCondition()
*/
result RegisterCondition(const Tizen::Base::String& wapApplicationId, const Tizen::Base::String& contentType);
- /**
- * Unregisters a condition to receive WAP push message.
+ /**
+ * Unregisters a condition to receive a WAP push message.
*
* @since 2.0
* @privlevel platform
*
* @feature %http://tizen.org/feature/network.telephony
* @return An error code
- * @param[in] wapApplicationId The X-Wap-Application-Id indicating a WAP push application ID
- * @param[in] contentType The MIME content type of the content
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified @c contentType or @c wapApplicationId is invalid.
- * @exception E_ILLEGAL_ACCESS The application does not have the permission to unregister the conditions.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
+ * @param[in] wapApplicationId The X-Wap-Application-Id that indicates the WAP push application ID
+ * @param[in] contentType The MIME content type of the content
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG Either of the following conditions has occurred:
+ * - The specified @c contentType is invalid.
+ * - The specified @c wapApplicationId is invalid.
+ * @exception E_ILLEGAL_ACCESS The application does not have the permission to unregister the conditions.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
* @remarks Before calling this method, check whether the feature is supported by
// limitations under the License.
//
/**
-* @file FMsgWapPushMessage.h
-* @brief This is the header file for the %WapPushMessage class.
-*
-* This header file contains the declarations of the %WapPushMessage class.
-*/
+ * @file FMsgWapPushMessage.h
+ * @brief This is the header file for the %WapPushMessage class.
+ *
+ * This header file contains the declarations of the %WapPushMessage class.
+ */
#ifndef _FMSG_WAP_PUSH_MESSAGE_H_
#define _FMSG_WAP_PUSH_MESSAGE_H_
class _WapPushMessageImpl;
/**
-* @class WapPushMessage
-* @brief This class provides methods for handling a WAP Push message.
-*
-* @since 2.0
-*
-* @final This class is not intended for extension.
-*
-* The %WapPushMessage class provides methods for handling a WAP Push message. @n
-* The methods of this class fetches the header and the body of a WAP Push message.
-*/
+ * @class WapPushMessage
+ * @brief This class provides methods for handling a WAP Push message.
+ *
+ * @since 2.0
+ *
+ * @final This class is not intended for extension.
+ *
+ * The %WapPushMessage class provides methods for handling a WAP Push message. @n
+ * The methods of this class fetch the header and body of a WAP Push message.
+ */
class _OSP_EXPORT_ WapPushMessage
: public Tizen::Base::Object
{
public:
- /**
+ /**
* This destructor overrides Tizen::Base::Object::~Object().
*
* @since 2.0
public:
- /**
+ /**
* Gets the header of a message.
*
* @since 2.0
*
- * @return The header of a message @n
- * The header has X-Wap-Application-Id and Content-Type fields.
+ * @return The header of the message @n
+ * The header has the X-Wap-Application-Id and Content-Type fields.
*/
Tizen::Base::String GetHeader(void) const;
- /**
+ /**
* Gets the body of a message.
*
* @since 2.0
*
- * @return The body of a message @n
- * The value is @c null in case of an error.
+ * @return The body of the message, @n
+ * else @c null in case of an error
* @remarks
- * - The message body can be any MIME content-type.
- * - The specific error code can be accessed using the GetLastResult() method.
+ * - The message body can be any MIME content-type.
+ * - The specific error code can be accessed using the GetLastResult() method.
*/
Tizen::Base::ByteBuffer* GetBodyN(void) const;
- /**
- * Compares the calling instance with the specified instance.
+ /**
+ * Compares the specified instance with the current instance.
*
* @since 2.0
*
- * @return @c true if the specified instance of Tizen::Base::Object is equal to the calling %WapPushMessage instance, @n
+ * @return @c true if the specified instance of Tizen::Base::Object is equal to the current %WapPushMessage instance, @n
* else @c false
* @param[in] obj An instance of Tizen::Base::Object to compare
* @see Tizen::Base::Object::Equals()
*/
virtual bool Equals(const Tizen::Base::Object& obj) const;
- /**
+ /**
* Gets the hash value of the current instance.
*
* @since 2.0
*/
virtual int GetHashCode(void) const;
- /**
- * Gets the copied instance of the class.
+ /**
+ * Gets the copied instance of this class.
*
* @since 2.0
*
* @return An instance of %WapPushMessage, @n
- * else @c null in case of an error
+ * else @c null in case of an error
* @exception E_SUCCESS The method is successful.
* @exception E_OUT_OF_MEMORY The memory is insufficient.
* @remarks The specific error code can be accessed using the GetLastResult() method.