namespace Tizen.Messaging.Messages
{
/// <summary>
- /// A class for message management. It allows applications to use message service.
+ /// This class is used for the message management. It allows applications to use the message service.
/// </summary>
/// <privilege>http://tizen.org/privilege/message.read</privilege>
+ /// <since_tizen> 3 </since_tizen>
public static class MessagesManager
{
/// <summary>
/// Sends a message.
/// </summary>
/// <privilege>http://tizen.org/privilege/message.write</privilege>
- /// <param name="message">The message to be sent</param>
- /// <param name="saveToSentbox">The boolean variable to indicate sent message should be saved in sentbox or not</param>
- /// <returns>A task contains the result of message sending</returns>
- /// <exception cref="InvalidOperationException">Thrown when method failed due to invalid operation</exception>
- /// <exception cref="NotSupportedException">Thrown when message service is not supported</exception>
- /// <exception cref="ArgumentException">Thrown when input coordinates are invalid</exception>
- /// <exception cref="UnauthorizedAccessException">Thrown when application does not have proper privileges</exception>
+ /// <param name="message">The message to be sent.</param>
+ /// <param name="saveToSentbox">The boolean variable used to indicate whether the sent message should be saved in the sentbox or not.</param>
+ /// <returns>A task containing the result of message sending.</returns>
+ /// <exception cref="InvalidOperationException">Thrown when the method failed due to an invalid operation.</exception>
+ /// <exception cref="NotSupportedException">Thrown when the message service is not supported.</exception>
+ /// <exception cref="ArgumentException">Thrown when input coordinates are invalid.</exception>
+ /// <exception cref="UnauthorizedAccessException">Thrown when an application does not have proper privileges.</exception>
+ /// <since_tizen> 3 </since_tizen>
public static Task<SentResult> SendMessageAsync(Message message, bool saveToSentbox)
{
return MessagesManagerImpl.Instance.SendMessageAsync(message, saveToSentbox);
/// Searches for messages.
/// </summary>
/// <privilege>http://tizen.org/privilege/message.read</privilege>
- /// <param name="filter">The search filter for searching messages</param>
- /// <returns>A task contains the messages which fit with search filter</returns>
- /// <exception cref="InvalidOperationException">Thrown when method failed due to invalid operation</exception>
- /// <exception cref="NotSupportedException">Thrown when message service is not supported</exception>
- /// <exception cref="ArgumentException">Thrown when input coordinates are invalid</exception>
- /// <exception cref="OutOfMemoryException">Thrown when failed due to out of memory</exception>
- /// <exception cref="UnauthorizedAccessException">Thrown when application does not have proper privileges</exception>
+ /// <param name="filter">The search filter for searching messages.</param>
+ /// <returns>A task containing the messages, which match the search filter.</returns>
+ /// <exception cref="InvalidOperationException">Thrown when the method failed due to an invalid operation.</exception>
+ /// <exception cref="NotSupportedException">Thrown when the message service is not supported.</exception>
+ /// <exception cref="ArgumentException">Thrown when input coordinates are invalid.</exception>
+ /// <exception cref="OutOfMemoryException">Thrown when failed due to out of memory.</exception>
+ /// <exception cref="UnauthorizedAccessException">Thrown when an application does not have proper privileges.</exception>
+ /// <since_tizen> 3 </since_tizen>
public static Task<IEnumerable<Message>> SearchMessageAsync(MessagesSearchFilter filter)
{
return MessagesManagerImpl.Instance.SearchMessageAsync(filter);
}
/// <summary>
- /// (event) MessageReceived is raised when receiving a message.
+ /// The MessageReceived event that is raised when receiving a message.
/// </summary>
/// <privilege>http://tizen.org/privilege/message.read</privilege>
+ /// <since_tizen> 3 </since_tizen>
static public event EventHandler<MessageReceivedEventArgs> MessageReceived
{
add