Update for log and documentation

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

diff --git a/inc/FAppAppManager.h b/inc/FAppAppManager.h
index 004e0e1..6e3dd36 100755 (executable)
--- a/inc/FAppAppManager.h
+++ b/inc/FAppAppManager.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);
@@ -101,13 +100,10 @@ public:
         * The following example demonstrates how to use the %FindAppControlN() method to find the application control.
         *
         * @code
-        * ArrayList dataList(SingleObjectDeleter);
-        * dataList.Construct();
-        * dataList.Add(new String(L"tel:1234567900"));
-        * dataList.Add(new String(L"type:voice"));
+        * String telUri = L"tel:12345678900";
         *
-        * AppControl* pAc = AppManager::FindAppControlN(L"tizen.phone", L"http://tizen.org/appcontrol/operation/call");
-        * pAc->Start(&dataList, null);
+        * AppControl* pAc = AppManager::FindAppControlN(L"tizen.phone", L"http://tizen.org/appcontrol/operation/dial");
+        * pAc->Start(&telUri, null, null, null);
         * @endcode
         */
        static AppControl* FindAppControlN(const AppId& appId, const Tizen::Base::String& operationId);
@@ -715,6 +711,42 @@ public:
         */
        result GetActiveApp(AppId& appId);
 
+       /**
+        * Checks whether the specified application is declared as preferred application for any AppControl resolution
+        *
+        * @since         2.2
+        * @privlevel      platform
+        * @privilege     %http://tizen.org/privilege/appmanager.setting
+        *
+        * @return        @c true if the application is running, @n
+        *           else @c false
+        * @param[in]    appId                         Application ID
+        * @exception    E_SUCCESS                   The method is successful.
+        * @exception    E_SYSTEM                    The method cannot proceed due to a severe system error.
+        * @exception    E_APP_NOT_INSTALLED    The specified application is not installed.
+        * @exception    E_PRIVILEGE_DENIED       The application does not have the privilege to call this method.
+        * @remarks      The specific error code can be accessed using the GetLastResult() method.
+        * @remarks      For more information on AppControl resolution, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
+        */
+       bool IsUserPreferredAppForAppControlResolution(const AppId& appId) const;           
+
+       /**
+        * Clear user preference for all AppControl resolutions on the specified application.
+        *
+        * @since         2.2
+        * @privlevel      platform
+        * @privilege     %http://tizen.org/privilege/appmanager.setting
+        *
+        * @return        An error code
+        * @param[in]    appId                         The preferred application's ID
+        * @exception    E_SUCCESS                   The method is successful. 
+        * @exception    E_SYSTEM                    The method cannot proceed due to a severe system error.
+        * @exception    E_APP_NOT_INSTALLED    The specified application is not installed.
+        * @exception    E_PRIVILEGE_DENIED       The application does not have the privilege to call this method.
+        * @remarks      For more information on AppControl resolution, see <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
+        */
+       result ClearUserPreferenceForAppControlResolution(const AppId& appId);
+
 private:
        /**
         * This default constructor is intentionally declared as private to implement the %Singleton semantic.