Merge "Update deprecated libprivilege-control API functions." into tizen
[platform/framework/native/appfw.git] / inc / FAppIMapDataControlResponseListener.h
index 7c3fd13..9f9f011 100644 (file)
@@ -46,7 +46,7 @@ class _OSP_EXPORT_ IMapDataControlResponseListener
 
 public:
        /**
-        * This polymorphic destructor should be overridden if required.
+        * This polymorphic destructor should be overridden if required. @n
         * This way, the destructors of the derived classes are called when the destructor of this interface is called.
         *
         * @since       2.0
@@ -54,20 +54,20 @@ public:
        virtual ~IMapDataControlResponseListener(void) {}
 
        /**
-       * Called when the result value list is received from key-value structured data control provider. @n
+       * Called when the result value list is received from the key-value structured data control provider. @n
        * The application requesting the data control can get the result value list by implementing this listener. @n
-       * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result value set.
-       * It is called after MapDataControl::GetValue().
+       * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result value set.
+       * It is called after the MapDataControl::GetValue() method.
        *
        * @since        2.0
        *
        * @param[in]    reqId                           The request ID
        * @param[in]    providerId                      The data control provider ID
-       * @param[in]    dataId                          A string for identifying a specific map to get from @n
+       * @param[in]    dataId                          The string that identifies the specific map to obtain from @n
        *                                                                       The string consists of one or more components, separated by a slash('/').
-       * @param[in]    resultValueList         The result value list of data control request getting matching values @n
-       *                                                                       The type of objects contained in the specified @c resultValueList is
-       *                                                                       Tizen::Base::String class.
+       * @param[in]    resultValueList         The result value list of the data control request that gets the matching values @n
+       *                                                                       The type of objects contained in the specified @c resultValueList are
+       *                                                                       Tizen::Base::String.
        * @param[in]    providerResult          Set to @c true if the data control provider successfully processed the request getting the values, @n
        *                                                                       else @c false
        * @param[in]    pErrorMsg                       The error message from the data control provider
@@ -77,16 +77,16 @@ public:
                        bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
 
        /**
-       * Called when the response is received from key-value structured data control provider. @n
+       * Called when the response is received from the key-value structured data control provider. @n
        * The application requesting the data control can get the result by implementing this listener. @n
-       * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result response.
-       * It is called after MapDataControl::AddValue().
+       * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result response.
+       * It is called after the MapDataControl::AddValue() method.
        *
        * @since        2.0
        *
        * @param[in]    reqId                           The request ID
        * @param[in]    providerId                      The data control provider ID
-       * @param[in]    dataId                          A string for identifying a specific map to add to @n
+       * @param[in]    dataId                          The string that identifies the specific map to add to @n
        *                                                                       The string consists of one or more components, separated by a slash('/').
        * @param[in]    providerResult          Set to @c true if the data control provider successfully processed the request adding a value, @n
        *                                                                       else @c false
@@ -96,16 +96,16 @@ public:
                        const Tizen::Base::String& dataId, bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
 
        /**
-       * Called when the response is received from key-value structured data control provider. @n
-       * The application requesting the data control can get the result for some data controls by implementing this listener. @n
-       * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result response.
-       * It is called after MapDataControl::SetValue().
+       * Called when the response is received from the key-value structured data control provider. @n
+       * The application requesting the data control can get the result by implementing this listener. @n
+       * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result response.
+       * It is called after the MapDataControl::SetValue() method.
        *
        * @since        2.0
        *
        * @param[in]    reqId                           The request ID
        * @param[in]    providerId                      The data control provider ID
-       * @param[in]    dataId                          A string for identifying a specific map to update @n
+       * @param[in]    dataId                          The string that identifies the specific map to update @n
        *                                                                       The string consists of one or more components, separated by a slash('/').
        * @param[in]    providerResult          Set to @c true if the data control provider successfully processed the request replacing a value, @n
        *                                                                       else @c false
@@ -115,16 +115,16 @@ public:
                        const Tizen::Base::String& dataId, bool providerResult, const Tizen::Base::String* pErrorMsg) = 0;
 
        /**
-       * Called when the response is received from key-value structured data control provider. @n
-       * The application requesting the data control can get the result for some data controls by implementing this listener. @n
-       * This listener must be registered by MapDataControl::SetMapDataControlResponseListener() for receiving the result response.
-       * It is called after MapDataControl::RemoveValue().
+       * Called when the response is received from the key-value structured data control provider. @n
+       * The application requesting the data control can get the result by implementing this listener. @n
+       * This listener must be registered by the MapDataControl::SetMapDataControlResponseListener() method for receiving the result response.
+       * It is called after the MapDataControl::RemoveValue() method.
        *
        * @since        2.0
        *
        * @param[in]    reqId                           The request ID
        * @param[in]    providerId                      The data control provider ID
-       * @param[in]    dataId                          A string for identifying a specific map to remove from @n
+       * @param[in]    dataId                          The string that identifies the specific map to remove from @n
        *                                                                       The string consists of one or more components, separated by a slash('/').
        * @param[in]    providerResult          Set to @c true if the data control provider successfully processed the request removing a value, @n
        *                                                                       else @c false