Revert enabling common-service for setting info.

[platform/framework/native/appfw.git] / inc / FAppAppControl.h

diff --git a/inc/FAppAppControl.h b/inc/FAppAppControl.h
old mode 100755 (executable)
new mode 100644 (file)
index ef060f0..2d195cd
--- a/inc/FAppAppControl.h
+++ b/inc/FAppAppControl.h
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
@@ -62,7 +61,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_CONTACT;
 *
 * @brief       <i> [Deprecated] </i>
 * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
-*                              Instead of this variable, use the literal, L"tizen.calendar" or L"tizen.events".
+*                              Instead of this variable, use the literal, L"tizen.calendar".
 * @since       2.0
 * @endif
 */
@@ -107,6 +106,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_DIAL;
 * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
 *                              Instead of this variable, use the literal, L"tizen.phone" with operation L"http://tizen.org/appcontrol/operation/call".
 * @since       2.0
+* @privlevel   public
 * @privilege    %http://tizen.org/privilege/systeminfo
 *
 * @remarks Privilege is required to use this application control.
@@ -212,6 +212,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_AUDIO;
 * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
 *                              Instead of this variable, use the literal, L"tizen.internet".
 * @since       2.0
+* @privlevel   public
 * @privilege    %http://tizen.org/privilege/web.service
 * @endif
 */
@@ -295,7 +296,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CERTIFICATE_MA
 *
 * @brief       <i> [Deprecated] </i>
 * @deprecated  This variable is provided only for backward compatibility and will be deleted in the near future.
-*                              Instead of this variable, use the literal, L"tizen.calendar" or L"tizen.events".
+*                              Instead of this variable, use the literal, L"tizen.calendar".
 * @since       2.0
 * @endif
 */
@@ -312,6 +313,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CALENDAR;
 * @deprecated  This variable is provided only for backward compatibility and will be deleted in the near future.
 *                              Instead of this variable, use the literal, L"tizen.phone".
 * @since                       2.0
+* @privlevel   public
 * @privilege    %http://tizen.org/privilege/systeminfo
 *
 * @remarks Privilege is required to use this application control.
@@ -429,6 +431,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_AUDIO;
 * @deprecated  This variable is provided only for backward compatibility and will be deleted in the near future.
 *                              Instead of this variable, use the literal, L"tizen.internet".
 * @since                       2.0
+* @privlevel   public
 * @privilege   %http://tizen.org/privilege/web.service
 *
 * @remarks Privilege is required to use this application control.
@@ -1040,27 +1043,18 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_RESULT_TERMINATED;
 *
 *
 * @code
-*
-*      using namespace Tizen::Base::Collection;
 *      using namespace Tizen::App;
 *
 *      void
-*      MyAppClass::AppControlCallSample(void)
+*      MyAppClass::AppControlDialSample(void)
 *      {
-*              HashMap extraData;
-*              String telKey = L"tel";
-*              String telVal = L"1234567890";
-*              String typeKey = L"type";
-*              String typeVal = L"voice";
-*
-*              extraData.Construct();
-*              extraData.Add(&telKey, &telVal);
-*              extraData.Add(&typeKey, &typeVal);
-*
-*              AppControl* pAc = AppManager::FindAppControlN(L"tizen.phone", L"http://tizen.org/appcontrol/operation/call");
-*              if(pAc)
+*
+*              String telUri = L"tel:12345678900";
+*
+*              AppControl* pAc = AppManager::FindAppControlN(L"tizen.phone", L"http://tizen.org/appcontrol/operation/dial");
+*              if(pAc) 
 *              {
-*                      pAc->Start(null, null, &extraData, null);
+*                      pAc->Start(&telUri, null, null, null);
 *                      delete pAc;
 *              }
 *      }
@@ -1089,6 +1083,7 @@ public:
         *                              IAppControlResponseListener due to lack of argument capability. @n
         *                              Instead of using this method, use Start().
         * @since       2.0
+        * @privlevel   public
         * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return              An error code
@@ -1122,6 +1117,7 @@ public:
         * application is displayed.
         *
         * @since       2.0
+        * @privlevel   public
         * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return              An error code
@@ -1155,6 +1151,7 @@ public:
         * When the found application control is started, the URI pattern, MIME type, and extra data is delivered using IAppControlProviderEventListener.
         *
         * @since       2.0
+        * @privlevel   public
         * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return  An error code
@@ -1163,7 +1160,9 @@ public:
         * @param[in]   pDataType   The MIME type (RFC 2046) or file extension @n
         *                          The '.' prefix must be used when specifying the file extension.
         * @param[in]   pCategory       The application control category
-        * @param[in]   pExtraData      A pointer to an argument map of key and value pair where the key is of type String and the value is of type String or of type ArrayList of String to deliver to the resolved application @n
+        * @param[in]   pExtraData      A pointer to an argument map of key and value pair where the key is of type Tizen::Base::String and the value is of
+        *                                              type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String to deliver to
+        *                                              the resolved application @n
         *                                                      The maximum size is 16 kilo bytes.
         * @param[in]   pListener   A listener that gets notified
         * @exception   E_SUCCESS           The method is successful.
@@ -1172,7 +1171,6 @@ public:
         * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
         * @exception   E_SYSTEM                                The method cannot proceed due to a severe system error.
         * @exception E_ILLEGAL_ACCESS                          The application is not signed with the same certificate of target application. @b Since: @b 2.1  
-        * @see IAppControlResponseListener
         */
        static result FindAndStart(const Tizen::Base::String& operationId, const Tizen::Base::String* pUriPattern, const Tizen::Base::String* pDataType, const Tizen::Base::String* pCategory, const Tizen::Base::Collection::IMap* pExtraData, IAppControlResponseListener* pListener);