//
-// Open Service Platform
// Copyright (c) 2012 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
*
* @final This class is not intended for extension.
*
- * The %DeviceManager class provides listener to handle events for various external device,
- * such as a Bluetooth headset, HDMI, and headphone.
- * This class also gets the current state of the device. You cannot create an instance of this class directly.
+ * The %DeviceManager class provides listeners to handle events for various external device, such as a Bluetooth headset, HDMI,
+ * and headphone. This class also gets the current state of the device. You cannot create an instance of this class directly.
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/system/device_management.htm">External Device Management</a>.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
* @compatibility This method has compatibility issues with %Tizen API versions @b prior @b to @b 2.0. @n
- * For more information, see @ref DeviceManagerGetStatePage "here".
+ * For more information, see @ref DeviceManagerGetStatePage "here".
* @endif
*
* @param[in] deviceType The value from the enumerator DeviceType indicating the device
* @param[out] state The device <a href="../org.tizen.native.appprogramming/html/guide/system/device_management.htm">state</a> of type Tizen::Base::String
*
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_ARG The specified @c deviceType is not valid.
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_ARG The specified @c deviceType is not valid.
* @exception E_UNSUPPORTED_OPERATION The specified @c deviceType is not supported on this model.
*/
static result GetState(DeviceType deviceType, Tizen::Base::String& state);
* @page DeviceManagerGetStatePage Compatibility for GetState()
* @section DeviceManagerGetStatePageIssueSection Issues
* Implementation of this method in OSP compatible applications has the following issue: @n
- * The GetState() method does not return E_DEVICE_UNAVAILABLE anymore. The E_DEVICE_UNAVAILABLE exception is removed.
+ * The GetState() method does not return @c E_DEVICE_UNAVAILABLE anymore. The @c E_DEVICE_UNAVAILABLE exception is removed.
* @section DeviceManagerGetStatePageIssueSection Resolutions
- * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
+ * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use @c E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
* @endif
*/
/**
- * Adds a device event listener.
+ * Adds the device event listener.
*
* @if OSPCOMPAT
* @brief <i> [Compatibility] </i>
* @endif
- * @since 2.0
+ * @since 2.0
* @if OSPCOMPAT
* @compatibility This method has compatibility issues with %Tizen API versions @b prior @b to @b 2.0. @n
* For more information, see @ref DeviceManagerAddDeviceEventListenerPage "here".
* @endif
*
- * @return An error code
- * @param[in] deviceType The types of a device
- * @param[in] listener The device event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_ARG The specified @c deviceType is not valid.
- * @exception E_OBJ_ALREADY_EXIST The specified @c deviceType and @c listener are already registered.
+ * @return An error code
+ * @param[in] deviceType The device type
+ * @param[in] listener The device event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_ARG The specified @c deviceType is not valid.
+ * @exception E_OBJ_ALREADY_EXIST The specified @c deviceType and @c listener are already registered.
* @exception E_UNSUPPORTED_OPERATION The specified @c deviceType is not supported on this model.
*/
static result AddDeviceEventListener(DeviceType deviceType, IDeviceEventListener& listener);
* @page DeviceManagerAddDeviceEventListenerPage Compatibility for AddDeviceEventListener()
* @section DeviceManagerAddDeviceEventListenerPageIssueSection Issues
* Implementation of this method in OSP compatible applications has the following issue: @n
- * This AddDeviceEventListener() method does not return E_DEVICE_UNAVAILABLE anymore. The E_DEVICE_UNAVAILABLE exception is removed.
+ * This AddDeviceEventListener() method does not return @c E_DEVICE_UNAVAILABLE anymore. The @c E_DEVICE_UNAVAILABLE exception is removed.
* @section DeviceManagerAddDeviceEventListenerPageIssueSection Resolutions
- * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE exception.
+ * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use @c E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
* @endif
*/
/**
- * Removes a device event listener from all types of devices.
+ * Removes the device event listener from all types of devices.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
- * @param[in] deviceType The types of a device
- * @param[in] listener The device event listener
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_INVALID_ARG The specified @c deviceType is not valid.
- * @exception E_OBJ_NOT_FOUND The specified @c deviceType and @c listener are not registered.
+ * @return An error code
+ * @param[in] deviceType The types of a device
+ * @param[in] listener The device event listener
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_INVALID_ARG The specified @c deviceType is not valid.
+ * @exception E_OBJ_NOT_FOUND The specified @c deviceType and @c listener are not registered.
* @exception E_UNSUPPORTED_OPERATION The specified @c deviceType is not supported on this model.
*/
static result RemoveDeviceEventListener(DeviceType deviceType, IDeviceEventListener& listener);
* @page DeviceManagerRemoveDeviceEventListenerPage Compatibility for RemoveDeviceEventListener()
* @section DeviceManagerRemoveDeviceEventListenerPageIssueSection Issues
* Implementation of this method in OSP compatible applications has the following issue: @n
- * This RemoveDeviceEventListener() method does not return E_DEVICE_UNAVAILABLE anymore. The E_DEVICE_UNAVAILABLE exception is removed.
+ * This RemoveDeviceEventListener() method does not return @c E_DEVICE_UNAVAILABLE anymore. The @c E_DEVICE_UNAVAILABLE exception is removed.
* @section DeviceManagerRemoveDeviceEventListenerPageIssueSection Resolutions
- * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE exception.
+ * The E_UNSUPPORTED_OPERATION exception is added since Tizen. So, use @c E_UNSUPPORTED_OPERATION instead of E_DEVICE_UNAVAILABLE.
* @endif
*/
/**
- * Removes all device event listeners.
+ * Removes all the device event listeners.
*
- * @since 2.0
+ * @since 2.0
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
*/