Class Battery

View Source

Definition

Namespace:
Tizen.System
Assembly:
Tizen.System.dll
API Level:
3

The Battery class provides the properties and events for the device battery.


                
C#

                

                    
Copy

                    

                

            
public static class Battery
Inheritance
System.Object
Battery
Remarks

The Battery API provides the way to get the current battery capacity value (Percent), the battery state, and the charging state. It also provides the events for an application to receive the battery status change events from the device. To receive the battery event, the application should register with the respective EventHandler.

Properties

View Source

IsCharging

Gets the current charging state.

Declaration

                
C#

                

                    
Copy

                    

                

            
public static bool IsCharging { get; }
Property Value
Type Description
Boolean
API Level: 3
View Source

Level

Gets the current battery level.

Declaration

                
C#

                

                    
Copy

                    

                

            
public static BatteryLevelStatus Level { get; }
Property Value
Type Description
BatteryLevelStatus
API Level: 3
View Source

Percent

Gets the battery charge percentage.

Declaration

                
C#

                

                    
Copy

                    

                

            
public static int Percent { get; }
Property Value
Type Description
Int32

It returns an integer value from 0 to 100 that indicates the remaining battery charge as a percentage of the maximum level.
API Level: 3

Events

View Source

ChargingStateChanged

ChargingStatusChanged is triggered when the battery charging status is changed. This event is triggered when the charger is connected/disconnected.

Declaration

                
C#

                

                    
Copy

                    

                

            
public static event EventHandler<BatteryChargingStateChangedEventArgs> ChargingStateChanged
Event Type
Type Description
System.EventHandler<BatteryChargingStateChangedEventArgs>
Examples

                

                

                    
Copy

                    

                

            
public static async Task BatteryEventHandler()
{
    EventHandler<BatteryChargingStateChangedEventArgs> handler = null;
    handler = (object sender, BatteryChargingStateChangedEventArgs args) =>
    {
         Console.WriteLine("battery Level is: {0}", args.IsCharging);
    }
    Battery.ChargingStateChanged += handler;
    await Task.Delay(20000);
}
API Level: 3
View Source

LevelChanged

LevelChanged is triggered when the battery level is changed.

Declaration

                
C#

                

                    
Copy

                    

                

            
public static event EventHandler<BatteryLevelChangedEventArgs> LevelChanged
Event Type
Type Description
System.EventHandler<BatteryLevelChangedEventArgs>
Examples

                

                

                    
Copy

                    

                

            
public static async Task BatteryEventHandler()
{
    EventHandler<BatteryLevelChangedEventArgs> handler = null;
    handler = (object sender, BatteryLevelChangedEventArgs args) =>
    {
         Console.WriteLine("battery Level is: {0}", args.Level);
    }
    Battery.LevelChanged += handler;
    await Task.Delay(20000);
}
API Level: 3
View Source

PercentChanged

CapacityChanged is triggered when the battery charge percentage is changed.

Declaration

                
C#

                

                    
Copy

                    

                

            
public static event EventHandler<BatteryPercentChangedEventArgs> PercentChanged
Event Type
Type Description
System.EventHandler<BatteryPercentChangedEventArgs>
Examples

                

                

                    
Copy

                    

                

            
public static async Task BatteryEventHandler()
{
    EventHandler<BatteryPercentChangedEventArgs> handler = null;
    handler = (object sender, BatteryChargingStateChangedEventArgs args) =>
    {
         Console.WriteLine("battery Percent is: {0}", args.Percent);
    }
    Battery.PercentChanged += handler;
    await Task.Delay(20000);
}
API Level: 3