//
-// Open Service Platform
// Copyright (c) 2012 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
/**
* @if OSPCOMPAT
- * @if OSPDEPREC
* @class Battery
* @brief <i>[Deprecated]</i> This class provides methods to get information related to the battery charge.
*
* @deprecated This class is deprecated. Instead of using this class, use the PowerManager class.
* @final This class is not intended for extension.
*
- * The %Battery class provides methods to get the status related to battery levels and
- * determine whether the battery is currently being charged.
- * You cannot create an instance of this class directly.
+ * The %Battery class provides methods to get the status related to battery levels and determine whether the battery is
+ * currently being charged. 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/battery_status.htm">Battery Status</a>.
* @endif
- * @endif
*/
+
class _OSP_EXPORT_ Battery
: public Tizen::Base::Object
{
public:
/**
+ * @cond OSPDEPREC
* Gets the current charge remaining in the battery as a percentage.
*
* @deprecated This method is deprecated. Instead of using this method, use the PowerManager::GetCurrentBatteryLevelInPercentage() method.
* @since 2.0
- *
- * @return An error code
- * @param[out] level The percentage of the charge remaining in the battery
- * @exception E_SUCCESS The method is successful.
+ * @if OSPCOMPAT
+ * @brief <i>[Deprecated] [Compatibility] </i>
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompGetCurrentLevelInPercentage "here".
+ * @endif
+ * @return An error code
+ * @param[out] level The percentage of the charge remaining in the battery
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The battery service is not available.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
- * @remarks The resolution of the level is @c 1% since 2.0. The range of the level is @c 0 (Minimum) to @c 100 (Maximum).
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @remarks The resolution of the level is @c 1% since 2.0. The range of the level is @c 0 (Minimum) to @c 100 (Maximum).
+ * @endcond
*/
static result GetCurrentLevelInPercentage(int& level);
/**
+ * @if OSPCOMPAT
+ * @page CompGetCurrentLevelInPercentage Compatibility for current battery level
+ * @section CompGetCurrentLevelInPercentageIssue Issues
+ * Implementation of this method in %Tizen API versions prior to 2.1 has the following issue: @n
+ *
+ * - GetCurrentLevelInPercentage() is moved to PowerManager class.
+ *
+ * @section CompGetCurrentLevelInPercentageResolution Resolutions
+ * The issue mentioned above is resolved in %Tizen API version 2.1 as follows: @n
+ *
+ * - GetCurrentLevelInPercentage() is provided by PowerManager class.
+ * @endif
+ */
+
+ /**
+ * @cond OSPDEPREC
* Gets the current charging level of the battery.
*
* @deprecated This method is deprecated. Instead of using this method, use the PowerManager::GetCurrentBatteryLevel() method.
* @since 2.0
- *
- * @return An error code
+ * @if OSPCOMPAT
+ * @brief <i>[Deprecated] [Compatibility] </i>
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompGetCurrentLevel "here".
+ * @endif
+ * @return An error code
* @param[out] level A value from the enumerator BatteryLevel indicating the current charging level
- * @exception E_SUCCESS The method is successful.
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The battery service is not available.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @endcond
*/
static result GetCurrentLevel(BatteryLevel& level);
/**
+ * @if OSPCOMPAT
+ * @page CompGetCurrentLevel Compatibility for current battery level
+ * @section CompGetCurrentLevelIssue Issues
+ * Implementation of this method in %Tizen API versions prior to 2.1 has the following issue: @n
+ *
+ * - CompGetCurrentLevel() is moved to PowerManager class.
+ *
+ * @section CompGetCurrentLevelResolution Resolutions
+ * The issue mentioned above is resolved in %Tizen API version 2.1 as follows: @n
+ *
+ * - GetCurrentLevel() is supported by PowerManager class.
+ * @endif
+ */
+
+ /**
+ * @cond OSPDEPREC
* Checks whether the battery is currently charging.
*
* @deprecated This method is deprecated. Instead of using this method, use the PowerManager::IsCharging() method.
* @since 2.0
- *
+ * @if OSPCOMPAT
+ * @brief <i>[Deprecated] [Compatibility] </i>
+ * @compatibility This method has compatibility issues with OSP compatible applications. @n
+ * For more information, see @ref CompIsCharging "here".
+ * @endif
* @return An error code
* @param[out] charging Set to @c true if the charging cable is connected to the phone, @n
- * else @c false
- * @exception E_SUCCESS The method is successful.
+ * else @c false
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE The battery service is not available.
- * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @exception E_SYSTEM The method cannot proceed due to a severe system error.
+ * @endcond
*/
static result IsCharging(bool& charging);
+ /**
+ * @if OSPCOMPAT
+ * @page CompIsCharging Compatibility for current battery level
+ * @section CompIsChargingIssue Issues
+ * Implementation of this method in %Tizen API versions prior to 2.1 has the following issue: @n
+ *
+ * - IsCharging() is moved to PowerManager class.
+ *
+ * @section CompIsChargingResolution Resolutions
+ * The issue mentioned above is resolved in %Tizen API version 2.1 as follows: @n
+ *
+ * - IsCharging() is supported by PowerManager class.
+ * @endif
+ */
+
private:
/**
* This is the default constructor for this class. This default constructor is intentionally declared as private so that only the platform can create an instance.