[4.0] Update doxygen comment
[platform/core/uifw/dali-adaptor.git] / adaptors / tizen / key-grab.h
index 65d11e5..956200b 100755 (executable)
@@ -113,7 +113,7 @@ DALI_IMPORT_API bool UngrabKey( Window window, Dali::KEY daliKey );
 
 /**
  * @PLATFORM
- * @brief Grabs the list of keys specfied by @Dali::Vector of keys for @a window in @Vector of grabModes.
+ * @brief Grabs the list of keys specified by @Dali::Vector of keys for @a window in @Dali::Vector of grabModes.
  *
  * @details This function can be used for following example scenarios:
  * - TV - A user might want to change the volume or channel of the background TV contents while focusing on the foregrund app.
@@ -126,25 +126,27 @@ DALI_IMPORT_API bool UngrabKey( Window window, Dali::KEY daliKey );
  * @param[in] window The window to set
  * @param[in] daliKeyVector The Dali::Vector of key codes to grab (defined in key.h)
  * @param[in] grabModeVector The Dali::Vector of grab modes for the keys
- * @return Dali::Vector Size is zero when error occurs, true/false if the grab succeeds/fails.
+ * @param[in] returnVector The Dali::Vector of return boolean values for the results of multiple grab succeeds/fails
+ * @return bool false when error occurs
  */
-DALI_IMPORT_API Dali::Vector<bool> GrabKeyList( Window window, const Dali::Vector<Dali::KEY> daliKeyVector, const Dali::Vector<KeyGrabMode> grabModeVector);
+DALI_IMPORT_API bool GrabKeyList( Window window, const Dali::Vector<Dali::KEY>& daliKeyVector, const Dali::Vector<KeyGrabMode>& grabModeVector, Dali::Vector<bool>& returnVector);
 
 
 /**
  * @PLATFORM
- * @brief Ungrabs the list of keys specfied by @Dali::Vector of keys for @a window.
+ * @brief Ungrabs the list of keys specified by @Dali::Vector of keys for @a window.
  *
  * @SINCE_1_2.0
  * @PRIVLEVEL_PLATFORM
  * @PRIVILEGE_KEYGRAB
  * @param[in] window The window to set
  * @param[in] daliKeyVector The Dali::Vector of key codes to ungrab (defined in key.h)
- * @return Dali::Vector Size is zero when error occurs, true/false if the ungrab succeeds/fails.
+ * @param[in] returnVector The Dali::Vector of return boolean values for the results of multiple ungrab succeeds/fails
+ * @return bool false when error occurs
  * @note If this function is called between key down and up events of a grabbed key,
  * an application doesn't receive the key up event.
  */
-DALI_IMPORT_API Dali::Vector<bool> UngrabKeyList( Window window, const Dali::Vector<Dali::KEY> daliKeyVector );
+DALI_IMPORT_API bool UngrabKeyList( Window window, const Dali::Vector<Dali::KEY>& daliKeyVector, Dali::Vector<bool>& returnVector);
 
 
 } // namespace KeyGrab