X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=inc%2FFAppAppManager.h;h=fb862529c70f1fda81c5b080f69f97c5c5aac40c;hb=f26b0f83d7c103adbd5468d05b5b89772563041f;hp=582892c5e397f6a02a41dce8f33447c311260379;hpb=723cb43de71991cb05e4f6558dc3c680e0f2a90e;p=platform%2Fframework%2Fnative%2Fappfw.git diff --git a/inc/FAppAppManager.h b/inc/FAppAppManager.h old mode 100755 new mode 100644 index 582892c..fb86252 --- 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); @@ -375,7 +371,7 @@ public: * @since 2.0 * @privlevel public * @privilege %http://tizen.org/privilege/application.launch - * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'" or %http://tzen.org/feature/usb.accessory for "Serial='command'" in the value of @c condition + * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'" or %http://tizen.org/feature/usb.accessory for "Serial='command'" in the value of @c condition * * @return An error code * @param[in] condition The launch condition for the application @n @@ -387,7 +383,7 @@ public: L"DueTime='mm/dd/yyyy hh:mm:ss' LaunchPeriod='mm'" The specific condition is the time period after due time. L"WeeklyTime='EEE HH:mm:ss'" - The specified condition is a day of a week with a specific time at which the application is launched on a weekly basis. For multiple descriptions, "," delimiter can be used as shown in the following example:
i"Mon 09:00:00, Tue 09:00:00, Wed 09:00:00, Thu 09:00:00, Fri 09:00:00"
To specify the day of the week, it must be in one of the following supported string format:
Mon: Monday
Tue: Tuesday
Wed: Wednesday
Thu: Thursday
Fri: Friday
Sat: Saturday
Sun: Sunday + The specified condition is a day of a week with a specific time at which the application is launched on a weekly basis. For multiple descriptions, "," delimiter can be used as shown in the following example:
i"'Mon 09:00:00', 'Tue 09:00:00', 'Wed 09:00:00', 'Thu 09:00:00', 'Fri 09:00:00'"
To specify the day of the week, it must be in one of the following supported string format:
Mon: Monday
Tue: Tuesday
Wed: Wednesday
Thu: Thursday
Fri: Friday
Sat: Saturday
Sun: Sunday L"Serial='command'"The specified condition is a serial communication input command. L"NFC='command'"The specified condition is a Near Field Communication (NFC) tag that has the NFC Data Exchange Format (NDEF) data. @@ -501,7 +497,7 @@ public: * @since 2.0 * @privlevel partner * @privilege %http://tizen.org/privilege/appmanager.launch - * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'" or %http://tzen.org/feature/usb.accessory for L"Serial='command'" in the value of @c condition + * @feature %http://tizen.org/feature/network.nfc for L"NFC='command'" or %http://tizen.org/feature/usb.accessory for L"Serial='command'" in the value of @c condition * * @return An error code * @param[in] appId The ID of the application registered for launch @@ -513,6 +509,8 @@ public: The specified condition is the local due time. L"DueTime='mm/dd/yyyy hh:mm:ss' LaunchPeriod='mm'" The specific condition is the time period after due time. + L"WeeklyTime='EEE HH:mm:ss'" + The specified condition is a day of a week with a specific time at which the application is launched on a weekly basis. For multiple descriptions, "," delimiter can be used as shown in the following example:
i"'Mon 09:00:00', 'Tue 09:00:00', 'Wed 09:00:00', 'Thu 09:00:00', 'Fri 09:00:00'"
To specify the day of the week, it must be in one of the following supported string format:
Mon: Monday
Tue: Tuesday
Wed: Wednesday
Thu: Thursday
Fri: Friday
Sat: Saturday
Sun: Sunday L"Serial='command'"The specified condition is a serial communication input command. L"NFC='command'"The specified condition is a Near Field Communication (NFC) tag that has the NFC Data Exchange Format (NDEF) data. @@ -608,7 +606,6 @@ public: * @exception E_SUCCESS The method is successful. * @exception E_OBJ_ALREADY_EXIST The listener is already set. * @exception E_SYSTEM A system error has occurred. - * @see IAppCheckpointEventListener * */ result SetCheckpointEventListener(IAppCheckpointEventListener& listener); @@ -672,7 +669,6 @@ public: * @remarks Active application is the top most window with focus. * @see GetActiveApp() * @see RemoveActiveAppEventListener() - * @see IActiveAppEventListener */ result AddActiveAppEventListener(IActiveAppEventListener& listener); @@ -692,7 +688,6 @@ public: * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method. * @see GetActiveApp() * @see AddActiveAppEventListener() - * @see IActiveAppEventListener */ result RemoveActiveAppEventListener(IActiveAppEventListener& listener); @@ -715,6 +710,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 Application Controls. + */ + 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 Application Controls. + */ + result ClearUserPreferenceForAppControlResolution(const AppId& appId); + private: /** * This default constructor is intentionally declared as private to implement the %Singleton semantic.