Class BatteryStatistics

Definition

Namespace:: Tizen.Context.AppHistory

Assembly:: Tizen.Context.dll

API Level:: 4

This class provides APIs to query the battery consumption per application.


                C#
                
                    Copy
                    
                
            
public class BatteryStatistics : AppStatistics

Inheritance: Object

AppStatistics

BatteryStatistics

Constructors

View Source

BatteryStatistics()

The default constructor of BatteryStatistics class.

Declaration


                C#
                
                    Copy
                    
                
            
public BatteryStatistics()

Exceptions

Type	Condition
InvalidOperationException	Thrown when the method failed due to an internal error.
System.NotSupportedException	Thrown when the features are not supported.

API Level: 4

Feature: http://tizen.org/feature/app_historyhttp://tizen.org/feature/battery

View Source

BatteryStatistics(BatteryStatistics.SortOrderType)

The constructor of BatteryStatistics class.

Declaration


                C#
                
                    Copy
                    
                
            
public BatteryStatistics(BatteryStatistics.SortOrderType order)

Parameters

Type	Name	Description
BatteryStatistics.SortOrderType	order	The criteria of the battery statistics sorted by.

Exceptions

Type	Condition
System.ArgumentException	Thrown when an invalid argument is used.
InvalidOperationException	Thrown when the method failed due to an internal error.
System.NotSupportedException	Thrown when the features are not supported.

API Level: 4

Feature: http://tizen.org/feature/app_historyhttp://tizen.org/feature/battery

Properties

View Source

SortOrder

Gets the criteria of battery statistics sorted by.

Declaration


                C#
                
                    Copy
                    
                
            
public BatteryStatistics.SortOrderType SortOrder { get; }

Property Value

Type	Description
BatteryStatistics.SortOrderType	The criteria of battery statistics sorted by.

API Level: 4

Methods

View Source

GetLastFullyChargedTime()

Gets the last time when the device was fully charged.

Declaration


                C#
                
                    Copy
                    
                
            
public static DateTime GetLastFullyChargedTime()

Returns

Type	Description
System.DateTime	The last time when the device was fully charged.

Exceptions

Type	Condition
System.NotSupportedException	Thrown when the statistics is not supported.

API Level: 4

Feature: http://tizen.org/feature/app_historyhttp://tizen.org/feature/battery

View Source

Query(DateTime, DateTime)

Retrieves a given type of battery statistics.

Declaration


                C#
                
                    Copy
                    
                
            
public IReadOnlyList<BatteryStatisticsData> Query(DateTime startTime, DateTime endTime)

Parameters

Type	Name	Description
System.DateTime	startTime	The start time of the data to be aggregated.
System.DateTime	endTime	The end time of the data to be aggregated.

Returns

Type	Description
IReadOnlyList<BatteryStatisticsData>	Battery statistics data retrieved.

Exceptions

Type	Condition
System.ArgumentException	Thrown when an invalid argument is used.
InvalidOperationException	Thrown when invalid operation occurs.
System.NotSupportedException	Thrown when the features are not supported.
UnauthorizedAccessException	Thrown when the application has no privilege to retrieve the application history.

API Level: 4

Privilege Level: public

Privilege: http://tizen.org/privilege/apphistory.read

Feature: http://tizen.org/feature/app_historyhttp://tizen.org/feature/battery

View Source

Query(DateTime, DateTime, UInt32)

Retrieves a given type of battery statistics.

Declaration


                C#
                
                    Copy
                    
                
            
public IReadOnlyList<BatteryStatisticsData> Query(DateTime startTime, DateTime endTime, uint resultSize)

Parameters

Type	Name	Description
System.DateTime	startTime	The start time of the data to be aggregated.
System.DateTime	endTime	The end time of the data to be aggregated.
System.UInt32	resultSize	The number of data records to be retrieved.

Returns

Type	Description
IReadOnlyList<BatteryStatisticsData>	Battery statistics data retrieved.

Exceptions

Type	Condition
System.ArgumentException	Thrown when an invalid argument is used.
InvalidOperationException	Thrown when an invalid operation occurs.
System.NotSupportedException	Thrown when the features are not supported.
UnauthorizedAccessException	Thrown when the application has no privilege to retrieve the application history.