inc/FAppNotificationManager.h

   1 //
   2 // Open Service Platform
   3 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
   4 //
   5 // Licensed under the Apache License, Version 2.0 (the License);
   6 // you may not use this file except in compliance with the License.
   7 // You may obtain a copy of the License at
   8 //
   9 //     http://www.apache.org/licenses/LICENSE-2.0
  10 //
  11 // Unless required by applicable law or agreed to in writing, software
  12 // distributed under the License is distributed on an "AS IS" BASIS,
  13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 // See the License for the specific language governing permissions and
  15 // limitations under the License.
  16 //
  17
  18 /**
  19  * @file                FAppNotificationManager.h
  20  * @brief               This is the header file for the %NotificationManager class.
  21  *
  22  * This header file contains the declarations of the %NotificationManager class.
  23  */
  24
  25 #ifndef _FAPP_NOTIFICATION_MANAGER_H_
  26 #define _FAPP_NOTIFICATION_MANAGER_H_
  27
  28 #include <FBase.h>
  29 #include <FAppTypes.h>
  30
  31 namespace Tizen { namespace App
  32 {
  33
  34 /**
  35  * @if OSPDEPREC
  36  * The maximum length of the notification message.
  37  *
  38  * @brief               <i> [Deprecated] </i>
  39  *
  40  * @deprecated  This variable is deprecated. Instead of using this variable, use the Tizen::Shell::MAX_NOTIFICATION_MESSAGE_LENGTH variable.
  41  * @since       2.0
  42  * @endif
  43  */
  44 static const int MAX_NOTIFICATION_MESSAGE_LENGTH = 127;
  45
  46 /**
  47  * @if OSPDEPREC
  48  * The maximum length of the launch arguments for the notification in bytes.
  49  *
  50  * @brief               <i> [Deprecated] </i>
  51  *
  52  * @deprecated  This variable is deprecated. Instead of using this variable, use the Tizen::Shell::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH variable.
  53  * @since               2.0
  54  * @endif
  55  */
  56 static const int MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH = 1024;
  57
  58 /**
  59  * @if OSPDEPREC
  60  * The maximum length of the notification badge number.
  61  *
  62  * @brief               <i> [Deprecated] </i>
  63  *
  64  * @deprecated  This variable is deprecated. Instead of using this variable, use the Tizen::Shell::MAX_NOTIFICATION_BADGE_NUMBER variable.
  65  * @since       2.0
  66  * @endif
  67  */
  68 static const int MAX_NOTIFICATION_BADGE_NUMBER = 999;
  69
  70 /**
  71  * @if OSPDEPREC
  72  * @class               NotificationManager
  73  * @brief               <i> [Deprecated] </i> This class provides methods to alert the user about a notification.
  74  *
  75  * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
  76  * @since       2.0
  77  *
  78  * @final       This class is not intended for extension.
  79  *
  80  * The %NotificationManager class provides methods to alert the user about a notification.
  81  * @n
  82  * For more information about the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/notifications.htm">Notifications</a>.
  83  *
  84  * The following example demonstrates how to use the %NotificationManager class.
  85  *
  86  * @code
  87  *
  88  *      result
  89  *      MyClass::NotificationSample(void)
  90  *      {
  91  *              int badgeNumber;
  92  *              NotificationManager* pNotiMgr = new NotificationManager();
  93  *              pNotiMgr->Construct();
  94  *              badgeNumber = pNotiMgr->GetBadgeNumber();
  95  *              badgeNumber++;
  96  *              pNotiMgr->Notify(L"A new message has arrived.", badgeNumber);
  97  *
  98  *      }
  99  *
 100  * @endcode
 101  * @endif
 102  */
 103 class _OSP_EXPORT_ NotificationManager
 104         : public Tizen::Base::Object
 105 {
 106
 107 public:
 108         /**
 109          * @if OSPDEPREC
 110          * This is the default constructor for this class.
 111          *
 112          * @brief               <i> [Deprecated] </i>
 113          *
 114          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 115          * @since       2.0
 116          * @endif
 117          */
 118         NotificationManager(void);
 119
 120         /**
 121          * @if OSPDEPREC
 122          * This destructor overrides Tizen::Base::Object::~Object().
 123          *
 124          * @brief               <i> [Deprecated] </i>
 125          *
 126          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 127          * @since       2.0
 128          * @endif
 129          */
 130         virtual ~NotificationManager(void);
 131
 132         /**
 133          * @if OSPDEPREC
 134          * Initializes this instance of %NotificationManager.
 135          *
 136          * @brief               <i> [Deprecated] </i>
 137          *
 138          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 139          * @since       2.0
 140          *
 141          * @return              An error code
 142          * @exception   E_SUCCESS               The method is successful.
 143          * @exception   E_SYSTEM                A system error has occurred.
 144          * @exception   E_OUT_OF_MEMORY The memory is insufficient.
 145          * @endif
 146          */
 147         result Construct(void);
 148
 149         /**
 150          * @if OSPDEPREC
 151          * Gets the current badge number of the application icon.
 152          *
 153          * @brief               <i> [Deprecated] </i>
 154          *
 155          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 156          * @since       2.0
 157          * @privilege   %http://tizen.org/privilege/notification
 158          *
 159          * @return              The current badge number
 160          * @exception   E_SUCCESS                       The method is successful.
 161          * @exception   E_SYSTEM                        A system error has occurred.
 162          * @exception   E_OBJ_NOT_FOUND     The application is not installed.
 163          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 164          * @remarks The specific error code can be accessed using the GetLastResult() method. @n
 165          *          In case of failure, this method returns @c -1.
 166          * @endif
 167          */
 168         int GetBadgeNumber(void);
 169
 170         /**
 171          * @if OSPDEPREC
 172          * Notifies the user using a badge number.
 173          *
 174          * @brief               <i> [Deprecated] </i>
 175          *
 176          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 177          * @since       2.0
 178          * @privilege   %http://tizen.org/privilege/notification
 179          *
 180          * @return              An error code
 181          * @param[in]   badgeNumber                     The badge number
 182          * @exception   E_SUCCESS                       The method is successful.
 183          * @exception   E_INVALID_ARG           The specified input parameter is invalid, or
 184          *                                  the specified @c badgeNumber is less than @c 0.
 185          * @exception   E_SYSTEM                        A system error has occurred.
 186          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 187          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 188          * @endif
 189          */
 190         result Notify(int badgeNumber);
 191
 192         /**
 193          * @if OSPDEPREC
 194          * Notifies the user using a message.
 195          *
 196          * @brief               <i> [Deprecated] </i>
 197          *
 198          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 199          * @since       2.0
 200          * @privilege   %http://tizen.org/privilege/notification
 201          *
 202          * @return              An error code
 203          * @param[in]   messageText                     The notification message
 204          * @exception   E_SUCCESS                       The method is successful.
 205          * @exception   E_INVALID_ARG           The specified input parameter is invalid, or
 206          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 207          * @exception   E_SYSTEM                        A system error has occurred.
 208          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 209          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 210          * @endif
 211          */
 212         result Notify(const Tizen::Base::String& messageText);
 213
 214         /**
 215          * @if OSPDEPREC
 216          * Notifies the user using a message and badge number.
 217          *
 218          * @brief               <i> [Deprecated] </i>
 219          *
 220          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 221          * @since       2.0
 222          * @privilege   %http://tizen.org/privilege/notification
 223          *
 224          * @return              An error code
 225          * @param[in]   messageText                     The notification message
 226          * @param[in]   badgeNumber                     The badge number
 227          * @exception   E_SUCCESS                       The method is successful.
 228          * @exception   E_INVALID_ARG           The specified @c badgeNumber is less than @c 0, or
 229          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 230          * @exception   E_SYSTEM                        A system error has occurred.
 231          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 232          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 233          * @endif
 234          */
 235         result Notify(const Tizen::Base::String& messageText, int badgeNumber);
 236
 237         /**
 238          * @if OSPDEPREC
 239          * Notifies the user using a message and badge number. @n
 240          * If the user checks the message, @c launchArguments is delivered to the application. @n
 241          * @c launchArguments is delivered as the value of the http://tizen.org/appcontrol/data/notification key
 242          * for IAppControlProviderEventListener::OnAppControlRequestReceived().
 243          *
 244          * @brief               <i> [Deprecated] </i>
 245          *
 246          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 247          * @since       2.0
 248          * @privilege   %http://tizen.org/privilege/notification
 249          *
 250          * @return              An error code
 251          * @param[in]   messageText                     The notification message
 252          * @param[in]   badgeNumber                     The badge number
 253          * @param[in]   launchArguments         The message for application
 254          * @exception   E_SUCCESS                       The method is successful.
 255          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 256          *                                                                      - A specified input parameter is invalid. @n
 257          *                                                                      - The specified @c badgeNumber is less than @c 0. @n
 258          *                                                                      - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 259          *                                                                      - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 260          * @exception   E_SYSTEM                        A system error has occurred.
 261          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 262          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 263          * @see                 IAppControlProviderEventListener::OnAppControlRequestReceived()
 264          * @endif
 265          */
 266         result Notify(const Tizen::Base::String& messageText, int badgeNumber, const Tizen::Base::String& launchArguments);
 267
 268         /**
 269          * @if OSPDEPREC
 270          * Removes the notification message.
 271          *
 272          * @brief               <i> [Deprecated] </i>
 273          *
 274          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 275          * @since                       2.0
 276          * @privilege   %http://tizen.org/privilege/notification
 277          *
 278          * @return              An error code
 279          * @exception   E_SUCCESS       The method is successful.
 280          * @exception   E_SYSTEM        A system error has occurred.
 281          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 282          * @remarks      This method returns @c E_SUCCESS when there is no outstanding notification.
 283          * @endif
 284          */
 285         result RemoveNotification(void);
 286
 287         /**
 288          * @if OSPDEPREC
 289          * Notifies the user about the ongoing activity using a message.
 290          *
 291          * @brief               <i> [Deprecated] </i>
 292          *
 293          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 294          * @since                               2.0
 295          * @privilege   %http://tizen.org/privilege/notification
 296          *
 297          * @return              An error code
 298          * @param[in]   messageText                     The notification message
 299          * @exception   E_SUCCESS                       The method is successful.
 300          * @exception   E_INVALID_ARG           The specified input parameter is invalid, or
 301          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 302          * @exception   E_SYSTEM                        A system error has occurred.
 303          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 304          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 305          * @endif
 306          */
 307         result NotifyOngoingActivity(const Tizen::Base::String& messageText);
 308
 309         /**
 310          * @if OSPDEPREC
 311          * Notifies the user about the ongoing activity using a message. @n
 312          * @c launchArguments is delivered as the value of the http://tizen.org/appcontrol/data/notification key
 313          * for IAppControlProviderEventListener::OnAppControlRequestReceived().
 314          *
 315          * @brief               <i> [Deprecated] </i>
 316          *
 317          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 318          * @since                               2.0
 319          * @privilege   %http://tizen.org/privilege/notification
 320          *
 321          * @return              An error code
 322          * @param[in]   messageText                     The notification message
 323          * @param[in]  launchArguments  The launch arguments for the application
 324          * @exception   E_SUCCESS                       The method is successful.
 325          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 326          *                                                                      - A specified input parameter is invalid. @n
 327          *                                                                      - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 328          *                                                                      - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 329          * @exception   E_SYSTEM                        A system error has occurred.
 330          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 331          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 332          * @endif
 333          */
 334         result NotifyOngoingActivity(const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
 335
 336         /**
 337          * @if OSPDEPREC
 338          * Removes the notification message for the ongoing activity.
 339          *
 340          * @brief               <i> [Deprecated] </i>
 341          *
 342          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 343          * @since                       2.0
 344          * @privilege   %http://tizen.org/privilege/notification
 345          *
 346          * @return              An error code
 347          * @exception   E_SUCCESS                       The method is successful.
 348          * @exception   E_SYSTEM                        A system error has occurred.
 349          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 350          * @remarks      This method returns @c E_SUCCESS when there is no outstanding notification.
 351          * @endif
 352          */
 353         result RemoveOngoingActivityNotification(void);
 354
 355         /**
 356          * @if OSPDEPREC
 357          * Gets the badge number of the application icon.
 358          *
 359          * @brief               <i> [Deprecated] </i>
 360          *
 361          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 362          * @since       2.0
 363          * @privilege   %http://tizen.org/privilege/notification
 364          *
 365          * @return              The current badge number
 366          * @param[in]   appId                           The application ID
 367          * @exception   E_SUCCESS                       The method is successful.
 368          * @exception   E_SYSTEM                        A system error has occurred.
 369          * @exception   E_OBJ_NOT_FOUND     The application is not installed.
 370          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 371          * @remarks The specific error code can be accessed using the GetLastResult() method. @n
 372          *                      In case of failure, this method returns @c -1.
 373          * @endif
 374          */
 375         int GetBadgeNumber(const AppId& appId);
 376
 377         /**
 378          * @if OSPDEPREC
 379          * Notifies the user using a badge number on behalf of the specified application.
 380          *
 381          * @brief               <i> [Deprecated] </i>
 382          *
 383          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 384          * @since       2.0
 385          *
 386          * @privlevel   public
 387          * @privilege   %http://tizen.org/privilege/notification @n
 388          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 389          *
 390          * @return              An error code
 391          * @param[in]   appId                           The application ID
 392          * @param[in]   badgeNumber                     The badge number
 393          * @exception   E_SUCCESS                       The method is successful.
 394          * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
 395          *                                  the specified @c badgeNumber is less than @c 0.
 396          * @exception   E_APP_NOT_INSTALLED  The application is not installed.
 397          * @exception   E_INVALID_OPERATION     The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
 398          * @exception   E_SYSTEM                        A system error has occurred.
 399          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 400          * @endif
 401          */
 402         result NotifyOnBehalf(const AppId& appId, int badgeNumber);
 403
 404         /**
 405          * @if OSPDEPREC
 406          * Notifies the user using a message on behalf of the specified application.
 407          *
 408          * @brief               <i> [Deprecated] </i>
 409          *
 410          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 411          * @since       2.0
 412          *
 413          * @privlevel   public
 414          * @privilege   %http://tizen.org/privilege/notification @n
 415          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 416          *
 417          * @return              An error code
 418          * @param[in]   appId                           The application ID
 419          * @param[in]   messageText                     The notification message
 420          * @exception   E_SUCCESS                       The method is successful.
 421          * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
 422          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 423          * @exception   E_APP_NOT_INSTALLED  The application is not installed.
 424          * @exception   E_INVALID_OPERATION     The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
 425          * @exception   E_SYSTEM                        A system error has occurred.
 426          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 427          * @endif
 428          */
 429         result NotifyOnBehalf(const AppId& appId, const Tizen::Base::String& messageText);
 430
 431         /**
 432          * @if OSPDEPREC
 433          * Notifies the user using a message and badge number on behalf of the specified application.
 434          *
 435          * @brief               <i> [Deprecated] </i>
 436          *
 437          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 438          * @since       2.0
 439          *
 440          * @privlevel   public
 441          * @privilege   %http://tizen.org/privilege/notification @n
 442          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 443          *
 444          * @return              An error code
 445          * @param[in]   appId                           The application ID
 446          * @param[in]   messageText                     The notification message
 447          * @param[in]   badgeNumber                     The badge number
 448          * @exception   E_SUCCESS                       The method is successful.
 449          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 450          *                                                                      - A specified input parameter is invalid. @n
 451          *                                                                      - The specified @c badgeNumber is less than @c 0. @n
 452          *                                                                      - The length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 453          * @exception   E_APP_NOT_INSTALLED  The application is not installed.
 454          * @exception   E_INVALID_OPERATION     The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
 455          * @exception   E_SYSTEM                        A system error has occurred.
 456          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 457          * @endif
 458          */
 459         result NotifyOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, int badgeNumber);
 460
 461         /**
 462          * @if OSPDEPREC
 463          * Notifies the user using a message and badge number on behalf of the specified application. @n
 464          * If the user checks the message, the @c launchArguments is delivered to the application.
 465          *
 466          * @brief               <i> [Deprecated] </i>
 467          *
 468          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 469          * @since               2.0
 470          *
 471          * @privlevel   public
 472          * @privilege   %http://tizen.org/privilege/notification @n
 473          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 474          *
 475          * @return             An error code
 476          * @param[in]  appId                            The application ID
 477          * @param[in]  messageText              The notification message
 478          * @param[in]  launchArguments  The launch arguments for the application
 479          * @exception  E_SUCCESS                        The method is successful.
 480          * @exception  E_INVALID_ARG            Either of the following conditions has occurred: @n
 481          *                                                              - A specified input parameter is invalid. @n
 482          *                                                              - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 483          *                                                              - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 484          * @exception  E_APP_NOT_INSTALLED      The application is not installed.
 485          * @exception  E_INVALID_OPERATION      The target application with the specified application ID is not permitted to receive any notification as per the %Tizen platform policy.
 486          * @exception  E_SYSTEM                         A system error has occurred.
 487          * @exception E_PRIVILEGE_DENIED                The application does not have the privilege to call this method.
 488          * @endif
 489          */
 490         result NotifyOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
 491
 492         /**
 493          * @if OSPDEPREC
 494          * Notifies the user about the ongoing activity using a message on behalf of the specified application.
 495          *
 496          * @brief               <i> [Deprecated] </i>
 497          *
 498          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 499          * @since                               2.0
 500          *
 501          * @privlevel   public
 502          * @privilege   %http://tizen.org/privilege/notification @n
 503          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 504          *
 505          * @return              An error code
 506          * @param[in]   appId                           The application ID
 507          * @param[in]   messageText                     The notification message
 508          * @exception   E_SUCCESS                       The method is successful.
 509          * @exception   E_INVALID_ARG           The specified input parameter is invalid, or
 510          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 511          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 512          * @exception   E_SYSTEM                        A system error has occurred.
 513          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 514          * @exception E_PRIVILEGE_DENIED                The application does not have the privilege to call this method.
 515          * @endif
 516          */
 517         result NotifyOngoingActivityOnBehalf(const AppId& appId, const Tizen::Base::String& messageText);
 518
 519         /**
 520          * @if OSPDEPREC
 521          * Notifies the user about the ongoing activity using a message on behalf of the specified application.
 522          *
 523          * @brief               <i> [Deprecated] </i>
 524          *
 525          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 526          * @since                               2.0
 527          *
 528          * @privlevel   public
 529          * @privilege   %http://tizen.org/privilege/notification @n
 530          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 531          *
 532          * @return              An error code
 533          * @param[in]   appId                           The application ID
 534          * @param[in]   messageText                     The notification message
 535          * @param[in]  launchArguments  The launch arguments for application
 536          * @exception   E_SUCCESS                       The method is successful.
 537          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 538          *                                                                      - A specified input parameter is invalid. @n
 539          *                                                                      - The length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 540          *                                                                      - The length of @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 541          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 542          * @exception   E_SYSTEM                        A system error has occurred.
 543          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 544          * @exception E_PRIVILEGE_DENIED                The application does not have the privilege to call this method.
 545          * @endif
 546          */
 547         result NotifyOngoingActivityOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
 548
 549         /**
 550          * @if OSPDEPREC
 551          * Removes the notification message for the ongoing activity on behalf of the specified application.
 552          *
 553          * @brief               <i> [Deprecated] </i>
 554          *
 555          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 556          * @since                       2.0
 557          *
 558          * @privlevel   public
 559          * @privilege   %http://tizen.org/privilege/notification @n
 560          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 561          *
 562          * @return              An error code
 563          * @param[in]   appId                           The application ID
 564          * @exception   E_SUCCESS                       The method is successful.
 565          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 566          * @exception   E_SYSTEM                        A system error has occurred.
 567          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 568          * @remarks             Although there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
 569          * @endif
 570          */
 571         result RemoveOngoingActivityNotificationOnBehalf(const AppId& appId);
 572
 573         /**
 574          * @if OSPDEPREC
 575          * Removes the notification message on behalf of the specified application.
 576          *
 577          * @brief               <i> [Deprecated] </i>
 578          *
 579          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 580          * @since                       2.0
 581          *
 582          * @privlevel   public
 583          * @privilege   %http://tizen.org/privilege/notification @n
 584          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 585          *
 586          * @return              An error code
 587          * @param[in]   appId                           The application ID
 588          * @exception   E_SUCCESS                       The method is successful.
 589          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 590          * @exception   E_SYSTEM                        A system error has occurred.
 591          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 592          * @remarks             Although there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
 593          * @endif
 594          */
 595         result RemoveNotificationOnBehalf(const AppId& appId);
 596
 597 private:
 598         /**
 599          * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
 600          *
 601          * @since       2.0
 602          */
 603         NotificationManager(const NotificationManager& rhs);
 604
 605         /**
 606          * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
 607          *
 608          * @since       2.0
 609          */
 610         NotificationManager& operator =(const NotificationManager& rhs);
 611
 612 private:
 613         class _NotificationManagerImpl * __pNotificationManagerImpl;
 614
 615         friend class _NotificationManagerImpl;
 616 }; // NotificationManager
 617
 618 } } // Tizen::App
 619
 620 #endif // _FAPP_NOTIFICATION_MANAGER_H_