inc/FAppNotificationManager.h

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