Battery Battery Battery Battery Battery Class

Definition

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

public : sealed class Battery : IBattery
struct winrt::Windows::Phone::Devices::Power::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 RemainingChargePercent

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

public : int RemainingChargePercent { get; }
int32_t RemainingChargePercent();
public int RemainingChargePercent { get; }
Public ReadOnly Property RemainingChargePercent As int
var int = battery.remainingChargePercent;
Value
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 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; }
TimeSpan RemainingDischargeTime();
public TimeSpan RemainingDischargeTime { get; }
Public ReadOnly Property RemainingDischargeTime As TimeSpan
var timeSpan = battery.remainingDischargeTime;
Value
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() GetDefault()

Gets the default Battery object for the phone.

public : static Battery GetDefault()
Battery GetDefault() const;
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 RemainingChargePercentChanged

Occurs when the value of RemainingChargePercent decreases by 1%.

public : event EventHandler RemainingChargePercentChanged<Platform::Object>
// Register
event_token RemainingChargePercentChanged(EventHandler<Platform::Object> const& handler) const;

// Revoke with event_token
void RemainingChargePercentChanged(event_token const& cookie) const;

// Revoke with event_revoker
RemainingChargePercentChanged_revoker RemainingChargePercentChanged(auto_revoker_t, EventHandler<Platform::Object> const& handler) const;
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);