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  * @n
  83  * For more information about 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
 161          * @exception   E_SUCCESS                       The method is successful.
 162          * @exception   E_SYSTEM                        A system error has occurred.
 163          * @exception   E_OBJ_NOT_FOUND     The application is not installed.
 164          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 165          * @remarks The specific error code can be accessed using the GetLastResult() method. @n
 166          *          In case of failure, this method returns @c -1.
 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           The specified input parameter is invalid, or
 185          *                                  the specified @c badgeNumber is less than @c 0.
 186          * @exception   E_SYSTEM                        A system error has occurred.
 187          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 188          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 189          * @endif
 190          */
 191         result Notify(int badgeNumber);
 192
 193         /**
 194          * @if OSPDEPREC
 195          * Notifies the user using a message.
 196          *
 197          * @brief               <i> [Deprecated] </i>
 198          *
 199          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 200          * @since       2.0
 201          * @privilege   %http://tizen.org/privilege/notification
 202          *
 203          * @return              An error code
 204          * @param[in]   messageText                     The notification message
 205          * @exception   E_SUCCESS                       The method is successful.
 206          * @exception   E_INVALID_ARG           The specified input parameter is invalid, or
 207          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 208          * @exception   E_SYSTEM                        A system error has occurred.
 209          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 210          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 211          * @endif
 212          */
 213         result Notify(const Tizen::Base::String& messageText);
 214
 215         /**
 216          * @if OSPDEPREC
 217          * Notifies the user using a message and badge number.
 218          *
 219          * @brief               <i> [Deprecated] </i>
 220          *
 221          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 222          * @since       2.0
 223          * @privilege   %http://tizen.org/privilege/notification
 224          *
 225          * @return              An error code
 226          * @param[in]   messageText                     The notification message
 227          * @param[in]   badgeNumber                     The badge number
 228          * @exception   E_SUCCESS                       The method is successful.
 229          * @exception   E_INVALID_ARG           The specified @c badgeNumber is less than @c 0, or
 230          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 231          * @exception   E_SYSTEM                        A system error has occurred.
 232          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 233          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 234          * @endif
 235          */
 236         result Notify(const Tizen::Base::String& messageText, int badgeNumber);
 237
 238         /**
 239          * @if OSPDEPREC
 240          * Notifies the user using a message and badge number. @n
 241          * If the user checks the message, @c launchArguments is delivered to the application. @n
 242          * @c launchArguments is delivered as the value of the %http://tizen.org/appcontrol/data/notification key
 243          * for IAppControlProviderEventListener::OnAppControlRequestReceived().
 244          *
 245          * @brief               <i> [Deprecated] </i>
 246          *
 247          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 248          * @since       2.0
 249          * @privilege   %http://tizen.org/privilege/notification
 250          *
 251          * @return              An error code
 252          * @param[in]   messageText                     The notification message
 253          * @param[in]   badgeNumber                     The badge number
 254          * @param[in]   launchArguments         The message for application
 255          * @exception   E_SUCCESS                       The method is successful.
 256          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 257          *                                                                      - A specified input parameter is invalid. @n
 258          *                                                                      - The specified @c badgeNumber is less than @c 0. @n
 259          *                                                                      - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 260          *                                                                      - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 261          * @exception   E_SYSTEM                        A system error has occurred.
 262          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 263          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 264          * @see                 IAppControlProviderEventListener::OnAppControlRequestReceived()
 265          * @endif
 266          */
 267         result Notify(const Tizen::Base::String& messageText, int badgeNumber, const Tizen::Base::String& launchArguments);
 268
 269         /**
 270          * @if OSPDEPREC
 271          * Removes the notification message.
 272          *
 273          * @brief               <i> [Deprecated] </i>
 274          *
 275          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 276          * @since                       2.0
 277          * @privilege   %http://tizen.org/privilege/notification
 278          *
 279          * @return              An error code
 280          * @exception   E_SUCCESS       The method is successful.
 281          * @exception   E_SYSTEM        A system error has occurred.
 282          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 283          * @remarks      This method returns @c E_SUCCESS when there is no outstanding notification.
 284          * @endif
 285          */
 286         result RemoveNotification(void);
 287
 288         /**
 289          * @if OSPDEPREC
 290          * Notifies the user about the ongoing activity using a message.
 291          *
 292          * @brief               <i> [Deprecated] </i>
 293          *
 294          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 295          * @since                               2.0
 296          * @privilege   %http://tizen.org/privilege/notification
 297          *
 298          * @return              An error code
 299          * @param[in]   messageText                     The notification message
 300          * @exception   E_SUCCESS                       The method is successful.
 301          * @exception   E_INVALID_ARG           The specified input parameter is invalid, or
 302          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 303          * @exception   E_SYSTEM                        A system error has occurred.
 304          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 305          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 306          * @endif
 307          */
 308         result NotifyOngoingActivity(const Tizen::Base::String& messageText);
 309
 310         /**
 311          * @if OSPDEPREC
 312          * Notifies the user about the ongoing activity using a message. @n
 313          * @c launchArguments is delivered as the value of the %http://tizen.org/appcontrol/data/notification key
 314          * for IAppControlProviderEventListener::OnAppControlRequestReceived().
 315          *
 316          * @brief               <i> [Deprecated] </i>
 317          *
 318          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 319          * @since                               2.0
 320          * @privilege   %http://tizen.org/privilege/notification
 321          *
 322          * @return              An error code
 323          * @param[in]   messageText                     The notification message
 324          * @param[in]  launchArguments  The launch arguments for the application
 325          * @exception   E_SUCCESS                       The method is successful.
 326          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 327          *                                                                      - A specified input parameter is invalid. @n
 328          *                                                                      - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 329          *                                                                      - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 330          * @exception   E_SYSTEM                        A system error has occurred.
 331          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 332          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 333          * @endif
 334          */
 335         result NotifyOngoingActivity(const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
 336
 337         /**
 338          * @if OSPDEPREC
 339          * Removes the notification message for the ongoing activity.
 340          *
 341          * @brief               <i> [Deprecated] </i>
 342          *
 343          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 344          * @since                       2.0
 345          * @privilege   %http://tizen.org/privilege/notification
 346          *
 347          * @return              An error code
 348          * @exception   E_SUCCESS                       The method is successful.
 349          * @exception   E_SYSTEM                        A system error has occurred.
 350          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 351          * @remarks      This method returns @c E_SUCCESS when there is no outstanding notification.
 352          * @endif
 353          */
 354         result RemoveOngoingActivityNotification(void);
 355
 356         /**
 357          * @if OSPDEPREC
 358          * Gets the badge number of the application icon.
 359          *
 360          * @brief               <i> [Deprecated] </i>
 361          *
 362          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 363          * @since       2.0
 364          * @privilege   %http://tizen.org/privilege/notification
 365          *
 366          * @return              The current badge number
 367          * @param[in]   appId                           The application ID
 368          * @exception   E_SUCCESS                       The method is successful.
 369          * @exception   E_SYSTEM                        A system error has occurred.
 370          * @exception   E_OBJ_NOT_FOUND     The application is not installed.
 371          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 372          * @remarks The specific error code can be accessed using the GetLastResult() method. @n
 373          *                      In case of failure, this method returns @c -1.
 374          * @endif
 375          */
 376         int GetBadgeNumber(const AppId& appId);
 377
 378         /**
 379          * @if OSPDEPREC
 380          * Notifies the user using a badge number on behalf of the specified application.
 381          *
 382          * @brief               <i> [Deprecated] </i>
 383          *
 384          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 385          * @since       2.0
 386          *
 387          * @privlevel   public
 388          * @privilege   %http://tizen.org/privilege/notification @n
 389          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 390          *
 391          * @return              An error code
 392          * @param[in]   appId                           The application ID
 393          * @param[in]   badgeNumber                     The badge number
 394          * @exception   E_SUCCESS                       The method is successful.
 395          * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
 396          *                                  the specified @c badgeNumber is less than @c 0.
 397          * @exception   E_APP_NOT_INSTALLED  The application is not installed.
 398          * @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.
 399          * @exception   E_SYSTEM                        A system error has occurred.
 400          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 401          * @endif
 402          */
 403         result NotifyOnBehalf(const AppId& appId, int badgeNumber);
 404
 405         /**
 406          * @if OSPDEPREC
 407          * Notifies the user using a message on behalf of the specified application.
 408          *
 409          * @brief               <i> [Deprecated] </i>
 410          *
 411          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 412          * @since       2.0
 413          *
 414          * @privlevel   public
 415          * @privilege   %http://tizen.org/privilege/notification @n
 416          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 417          *
 418          * @return              An error code
 419          * @param[in]   appId                           The application ID
 420          * @param[in]   messageText                     The notification message
 421          * @exception   E_SUCCESS                       The method is successful.
 422          * @exception   E_INVALID_ARG           A specified input parameter is invalid, or
 423          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 424          * @exception   E_APP_NOT_INSTALLED  The application is not installed.
 425          * @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.
 426          * @exception   E_SYSTEM                        A system error has occurred.
 427          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 428          * @endif
 429          */
 430         result NotifyOnBehalf(const AppId& appId, const Tizen::Base::String& messageText);
 431
 432         /**
 433          * @if OSPDEPREC
 434          * Notifies the user using a message and badge number on behalf of the specified application.
 435          *
 436          * @brief               <i> [Deprecated] </i>
 437          *
 438          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 439          * @since       2.0
 440          *
 441          * @privlevel   public
 442          * @privilege   %http://tizen.org/privilege/notification @n
 443          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 444          *
 445          * @return              An error code
 446          * @param[in]   appId                           The application ID
 447          * @param[in]   messageText                     The notification message
 448          * @param[in]   badgeNumber                     The badge number
 449          * @exception   E_SUCCESS                       The method is successful.
 450          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 451          *                                                                      - A specified input parameter is invalid. @n
 452          *                                                                      - The specified @c badgeNumber is less than @c 0. @n
 453          *                                                                      - The length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 454          * @exception   E_APP_NOT_INSTALLED  The application is not installed.
 455          * @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.
 456          * @exception   E_SYSTEM                        A system error has occurred.
 457          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 458          * @endif
 459          */
 460         result NotifyOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, int badgeNumber);
 461
 462         /**
 463          * @if OSPDEPREC
 464          * Notifies the user using a message and badge number on behalf of the specified application. @n
 465          * If the user checks the message, the @c launchArguments is delivered to the application.
 466          *
 467          * @brief               <i> [Deprecated] </i>
 468          *
 469          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 470          * @since               2.0
 471          *
 472          * @privlevel   public
 473          * @privilege   %http://tizen.org/privilege/notification @n
 474          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 475          *
 476          * @return             An error code
 477          * @param[in]  appId                            The application ID
 478          * @param[in]  messageText              The notification message
 479          * @param[in]  launchArguments  The launch arguments for the application
 480          * @exception  E_SUCCESS                        The method is successful.
 481          * @exception  E_INVALID_ARG            Either of the following conditions has occurred: @n
 482          *                                                              - A specified input parameter is invalid. @n
 483          *                                                              - The length of the specified @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 484          *                                                              - The length of the specified @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 485          * @exception  E_APP_NOT_INSTALLED      The application is not installed.
 486          * @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.
 487          * @exception  E_SYSTEM                         A system error has occurred.
 488          * @exception E_PRIVILEGE_DENIED                The application does not have the privilege to call this method.
 489          * @endif
 490          */
 491         result NotifyOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
 492
 493         /**
 494          * @if OSPDEPREC
 495          * Notifies the user about the ongoing activity using a message on behalf of the specified application.
 496          *
 497          * @brief               <i> [Deprecated] </i>
 498          *
 499          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 500          * @since                               2.0
 501          *
 502          * @privlevel   public
 503          * @privilege   %http://tizen.org/privilege/notification @n
 504          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 505          *
 506          * @return              An error code
 507          * @param[in]   appId                           The application ID
 508          * @param[in]   messageText                     The notification message
 509          * @exception   E_SUCCESS                       The method is successful.
 510          * @exception   E_INVALID_ARG           The specified input parameter is invalid, or
 511          *                                                                      the length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH.
 512          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 513          * @exception   E_SYSTEM                        A system error has occurred.
 514          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 515          * @exception E_PRIVILEGE_DENIED                The application does not have the privilege to call this method.
 516          * @endif
 517          */
 518         result NotifyOngoingActivityOnBehalf(const AppId& appId, const Tizen::Base::String& messageText);
 519
 520         /**
 521          * @if OSPDEPREC
 522          * Notifies the user about the ongoing activity using a message on behalf of the specified application.
 523          *
 524          * @brief               <i> [Deprecated] </i>
 525          *
 526          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 527          * @since                               2.0
 528          *
 529          * @privlevel   public
 530          * @privilege   %http://tizen.org/privilege/notification @n
 531          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 532          *
 533          * @return              An error code
 534          * @param[in]   appId                           The application ID
 535          * @param[in]   messageText                     The notification message
 536          * @param[in]  launchArguments  The launch arguments for application
 537          * @exception   E_SUCCESS                       The method is successful.
 538          * @exception   E_INVALID_ARG           Either of the following conditions has occurred: @n
 539          *                                                                      - A specified input parameter is invalid. @n
 540          *                                                                      - The length of @c messageText is greater than App::MAX_NOTIFICATION_MESSAGE_LENGTH. @n
 541          *                                                                      - The length of @c launchArguments is greater than App::MAX_NOTIFICATION_LAUNCH_ARGUMENTS_LENGTH.
 542          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 543          * @exception   E_SYSTEM                        A system error has occurred.
 544          * @exception   E_INVALID_OPERATION     The type of application calling this method is invalid as per the %Tizen platform policy.
 545          * @exception E_PRIVILEGE_DENIED                The application does not have the privilege to call this method.
 546          * @endif
 547          */
 548         result NotifyOngoingActivityOnBehalf(const AppId& appId, const Tizen::Base::String& messageText, const Tizen::Base::String& launchArguments);
 549
 550         /**
 551          * @if OSPDEPREC
 552          * Removes the notification message for the ongoing activity on behalf of the specified application.
 553          *
 554          * @brief               <i> [Deprecated] </i>
 555          *
 556          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 557          * @since                       2.0
 558          *
 559          * @privlevel   public
 560          * @privilege   %http://tizen.org/privilege/notification @n
 561          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 562          *
 563          * @return              An error code
 564          * @param[in]   appId                           The application ID
 565          * @exception   E_SUCCESS                       The method is successful.
 566          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 567          * @exception   E_SYSTEM                        A system error has occurred.
 568          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 569          * @remarks             Although there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
 570          * @endif
 571          */
 572         result RemoveOngoingActivityNotificationOnBehalf(const AppId& appId);
 573
 574         /**
 575          * @if OSPDEPREC
 576          * Removes the notification message on behalf of the specified application.
 577          *
 578          * @brief               <i> [Deprecated] </i>
 579          *
 580          * @deprecated  This class is deprecated. Instead of using this class, use the Tizen::Shell::NotificationManager class.
 581          * @since                       2.0
 582          *
 583          * @privlevel   public
 584          * @privilege   %http://tizen.org/privilege/notification @n
 585          *                              (%http://tizen.org/privilege/notificationmanager is deprecated.)
 586          *
 587          * @return              An error code
 588          * @param[in]   appId                           The application ID
 589          * @exception   E_SUCCESS                       The method is successful.
 590          * @exception   E_APP_NOT_INSTALLED     The application is not installed.
 591          * @exception   E_SYSTEM                        A system error has occurred.
 592          * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
 593          * @remarks             Although there is no outstanding notification for the calling application, this method returns @c E_SUCCESS.
 594          * @endif
 595          */
 596         result RemoveNotificationOnBehalf(const AppId& appId);
 597
 598 private:
 599         /**
 600          * The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
 601          *
 602          * @since       2.0
 603          */
 604         NotificationManager(const NotificationManager& rhs);
 605
 606         /**
 607          * The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
 608          *
 609          * @since       2.0
 610          */
 611         NotificationManager& operator =(const NotificationManager& rhs);
 612
 613 private:
 614         class _NotificationManagerImpl * __pNotificationManagerImpl;
 615
 616         friend class _NotificationManagerImpl;
 617 }; // NotificationManager
 618
 619 } } // Tizen::App
 620
 621 #endif // _FAPP_NOTIFICATION_MANAGER_H_