Battery Battery Battery Battery Class

Definition

Provides information about the status of the phone's battery.

public : sealed class Battery : IBattery
public sealed class Battery : IBattery
Public NotInheritable Class Battery Implements IBattery
// This class does not provide a public constructor.
Attributes
Windows 10 requirements
Device family
Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Phone.PhoneContract (introduced v1)

Remarks

Use the GetDefault method to retrieve an instance of the Battery class.

Properties

RemainingChargePercent RemainingChargePercent RemainingChargePercent RemainingChargePercent

Gets a value that indicates the percentage of the charge remaining on the phone's battery.

public : int RemainingChargePercent { get; }
public int RemainingChargePercent { get; }
Public ReadOnly Property RemainingChargePercent As int
var int = battery.remainingChargePercent;
Value
int int int int

A value from 0 to 100 that indicates the percentage of the charge remaining on the phone's battery.

RemainingDischargeTime RemainingDischargeTime RemainingDischargeTime RemainingDischargeTime

Gets a value that estimates how long is left until the phone's battery is fully discharged. Each unit value represents 100 nanoseconds.

public : TimeSpan RemainingDischargeTime { get; }
public TimeSpan RemainingDischargeTime { get; }
Public ReadOnly Property RemainingDischargeTime As TimeSpan
var timeSpan = battery.remainingDischargeTime;
Value
TimeSpan TimeSpan TimeSpan TimeSpan

A value that estimates how long is left until the phone's battery is fully discharged. Each unit value represents 100 nanoseconds.

Remarks

Divide by 10^7 to get the total number of seconds.

Methods

GetDefault() GetDefault() GetDefault() GetDefault()

Gets the default Battery object for the phone.

public : static Battery GetDefault()
public static Battery GetDefault()
Public Static Function GetDefault() As Battery
var battery = Windows.Phone.Devices.Power.Battery.getDefault();
Returns

The default Battery object for the phone.

Events

RemainingChargePercentChanged RemainingChargePercentChanged RemainingChargePercentChanged RemainingChargePercentChanged

Occurs when the value of RemainingChargePercent decreases by 1%.

public : event EventHandler RemainingChargePercentChanged<Platform::Object>
public event EventHandler RemainingChargePercentChanged<object>
Public Event EventHandler RemainingChargePercentChanged( Of ( Of object ))
function onRemainingChargePercentChanged(eventArgs){/* Your code */}


battery.addEventListener("remainingChargePercentChanged", onRemainingChargePercentChanged);
battery.removeEventListener("remainingChargePercentChanged", onRemainingChargePercentChanged);