[ACR][Add] Add appwidget feature, and add exception for optional feature.

Change-Id: I53238edb36406eaef3192b46917496f859d98f42
Signed-off-by: jungmin76.park <jungmin76.park@samsung.com>

diff --git a/inc/FShellAppWidgetFrame.h b/inc/FShellAppWidgetFrame.h
old mode 100644 (file)
new mode 100755 (executable)
index 55275e9..63ac8aa
--- a/inc/FShellAppWidgetFrame.h
+++ b/inc/FShellAppWidgetFrame.h
@@ -61,10 +61,14 @@ public:
         * Initializes this instance of %AppWidgetFrame with the specified parameter.
         *
         * @since       2.1
+        * @feature             %http://tizen.org/feature/shell.appwidget
         * @return      An error code
         * @param[in]   size                            The new width and height
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
+        * @exception   E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                                                                      For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        * remarks              Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
         * @see AppWidgetProvider::OnAppWidgetProviderInitialize()
         */
        result Construct(const Tizen::Graphics::FloatDimension& size);
@@ -73,11 +77,15 @@ public:
         * Initializes this instance of %AppWidgetFrame with the specified parameter.
         *
         * @since       2.1
+        * @feature             %http://tizen.org/feature/shell.appwidget
         * @return      An error code
         * @param[in]   layout                          The layout for both the portrait and landscape mode
         * @param[in]   size                            The new width and height
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
+        * @exception   E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                                                                      For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        * remarks              Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
         * @see AppWidgetProvider::OnAppWidgetProviderInitialize()
         */
        result Construct(const Tizen::Ui::Layout& layout, const Tizen::Graphics::FloatDimension& size);

diff --git a/inc/FShellAppWidgetManager.h b/inc/FShellAppWidgetManager.h
old mode 100644 (file)
new mode 100755 (executable)
index c99241d..8b7856f
--- a/inc/FShellAppWidgetManager.h
+++ b/inc/FShellAppWidgetManager.h
@@ -56,8 +56,18 @@ public:
         *
         * @since       2.1
         *
-        * @return      A pointer to the %AppWidgetManager instance, @n
-        *                      else @c null if it fails
+        * @feature        %http://tizen.org/feature/shell.appwidget\r
+        *\r
+        * @return             A pointer to the %AppWidgetManager instance, @n
+        *                             else @c null if it fails
+        *
+        * @exception      E_SUCCESS       The method is successful.
+        * @exception      E_SYSTEM        The method cannot proceed due to a severe system error.
+        * @exception      E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                 For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        *
+        * @remarks      - The specific error code can be accessed using the GetLastResult() method.
+        *               - Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
         */
        static AppWidgetManager* GetInstance(void);
 

diff --git a/inc/FShellAppWidgetPopup.h b/inc/FShellAppWidgetPopup.h
old mode 100644 (file)
new mode 100755 (executable)
index 5417f85..b88af96
--- a/inc/FShellAppWidgetPopup.h
+++ b/inc/FShellAppWidgetPopup.h
@@ -61,10 +61,14 @@ public:
         * Initializes this instance of %AppWidgetFrame with the specified parameter.
         *
         * @since       2.1
+        * @feature             %http://tizen.org/feature/shell.appwidget
         * @return      An error code
         * @param[in]   size                            The new width and height
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
+        * @exception   E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                                                                      For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        * remarks              Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
         * @see AppWidgetProvider::OnAppWidgetPopupProviderInitialize()
         */
        result Construct(const Tizen::Graphics::FloatDimension& size);
@@ -73,11 +77,15 @@ public:
         * Initializes this instance of %AppWidgetFrame with the specified parameter.
         *
         * @since       2.1
+        * @feature             %http://tizen.org/feature/shell.appwidget
         * @return      An error code
         * @param[in]   layout                          The layout for both the portrait and landscape mode
         * @param[in]   size                            The new width and height
         * @exception   E_SUCCESS           The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
+        * @exception   E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                                                                      For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        * remarks              Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
         * @see AppWidgetProvider::OnAppWidgetPopupProviderInitialize()
         */
        result Construct(const Tizen::Ui::Layout& layout, const Tizen::Graphics::FloatDimension& size);

diff --git a/inc/FShellAppWidgetProvider.h b/inc/FShellAppWidgetProvider.h
index a505edb..b2a3d89 100644 (file)
--- a/inc/FShellAppWidgetProvider.h
+++ b/inc/FShellAppWidgetProvider.h
@@ -131,7 +131,7 @@ protected:
         *
         * @remarks             This method is called when UpdatePeriod timer is expired or AppWidgetManager::RequestUpdate() is called.@n
         */
-       virtual bool OnAppWidgetProviderUpdating(const Tizen::Base::String& userInfo) = 0;
+       virtual bool OnAppWidgetProviderUpdating(const Tizen::Base::String& argument) = 0;
 
        /**
         * Sets the AppWidgetFrame instance to the AppWidgetProvider instance.

diff --git a/inc/FShellAppWidgetProviderManager.h b/inc/FShellAppWidgetProviderManager.h
old mode 100644 (file)
new mode 100755 (executable)
index ff29d0d..468d8b5
--- a/inc/FShellAppWidgetProviderManager.h
+++ b/inc/FShellAppWidgetProviderManager.h
@@ -57,8 +57,17 @@ public:
         *
         * @since       2.1
         *
-        * @return      A pointer to the %AppWidgetProviderManager instance, @n
-        *                      else @c null if it fails
+        * @feature        %http://tizen.org/feature/shell.appwidget\r
+        *
+        * @return         A pointer to the %AppWidgetProviderManager instance, @n
+        *                                 else @c null if it fails
+        * @exception      E_SUCCESS       The method is successful.\r
+        * @exception      E_SYSTEM        The method cannot proceed due to a severe system error.
+        * @exception      E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                 For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        *
+        * @remarks      - The specific error code can be accessed using the GetLastResult() method.
+        *               - Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.\r
         */
        static AppWidgetProviderManager* GetInstance(void);
 
@@ -81,7 +90,7 @@ public:
         *
         * @see                 AppWidgetProvider::OnAppWidgetProviderUpdating()
         */
-       result RequestUpdate(const Tizen::App::AppId& appId, const Tizen::Base::String& providerName, const Tizen::Base::String& userInfo = L"");
+       result RequestUpdate(const Tizen::App::AppId& appId, const Tizen::Base::String& providerName, const Tizen::Base::String& argument = L"");
 
        /**
         * Requests a AppWidget viewer (for example, Home screen, Lock screen) to add the specified AppWidget.

diff --git a/inc/FShellAppWidgetView.h b/inc/FShellAppWidgetView.h
old mode 100644 (file)
new mode 100755 (executable)
index 9951c8e..e727e35
--- a/inc/FShellAppWidgetView.h
+++ b/inc/FShellAppWidgetView.h
@@ -70,6 +70,7 @@ public:
         * Initializes this instance of %AppWidgetView with the specified parameter.
         *
         * @since       2.1
+        * @feature             %http://tizen.org/feature/shell.appwidget\r
         * @return      An error code
         * @param[in]   appId                           The AppId of the installed application
         * @param[in]   providerName            The name of the AppWidget provider
@@ -80,6 +81,9 @@ public:
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
         * @exception   E_APP_NOT_INSTALLED     The application is not installed.
         * @exception   E_OBJ_NOT_FOUND         The specified AppWidget provider is not found.
+        * @exception   E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                                                                      For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        * remarks              Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.\r
         */
        result Construct(const Tizen::App::AppId& appId, const Tizen::Base::String& providerName, const Tizen::Graphics::FloatRectangle& rect);
 
@@ -87,6 +91,7 @@ public:
         * Initializes this instance of %AppWidgetView with the specified parameter.
         *
         * @since       2.1
+        * @feature             %http://tizen.org/feature/shell.appwidget
         * @return      An error code
         * @param[in]   appId                           The AppId of the installed application
         * @param[in]   providerName            The name of the AppWidget provider
@@ -98,6 +103,9 @@ public:
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
         * @exception   E_APP_NOT_INSTALLED     The application is not installed.
         * @exception   E_OBJ_NOT_FOUND         The specified AppWidget provider is not found.
+        * @exception   E_UNSUPPORTED_OPERATION   The Emulator or target device does not support the required feature.\r
+        *                                                                      For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.\r
+        * remarks              Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
         */
        result Construct(const Tizen::App::AppId& appId, const Tizen::Base::String& providerName, const Tizen::Graphics::FloatRectangle& rect, const Tizen::Base::String& userInfo);