Battery Classe

Definição

Namespace:

Windows.Devices.Power

Fornece informações sobre um controlador de bateria que está atualmente conectado ao dispositivo. Para obter mais informações, consulte Obter informações sobre a bateria.

public ref class Battery sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Battery final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Battery

Public NotInheritable Class Battery

Herança

Object Platform::Object IInspectable Battery

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Nesse contexto, o dispositivo se refere ao hardware em que seu aplicativo está sendo executado. O controlador de bateria refere-se aos eletrônicos que fazem a interface entre a bateria física e o sistema operacional. Um controlador de bateria aparece em Gerenciador de Dispositivos como uma "Bateria" sob o nó Baterias.

Dependendo do dispositivo, pode ser possível remover a bateria física enquanto o dispositivo permanece em execução. Por exemplo, um laptop conectado à energia A/C. Nesse caso, se o controlador de bateria fizesse parte do compartimento do laptop, você poderia potencialmente criar um objeto Battery quando nenhuma bateria estiver conectada ao dispositivo. No entanto, se o controlador de bateria residisse na bateria física, ele não estaria mais visível para o sistema operacional e, portanto, você não poderia criar um objeto Battery correspondente para uma bateria individual.

Propriedades

AggregateBattery	Obtém um objeto Battery que representa todos os controladores de bateria conectados ao dispositivo.
DeviceId	Obtém o identificador (ID) de um controlador de bateria individual.

Métodos

FromIdAsync(String)	Obtém um objeto Battery que representa um controlador de bateria individual conectado ao dispositivo.
GetDeviceSelector()	Obtém uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) que pode ser usada para localizar todos os controladores de bateria conectados ao dispositivo.
GetReport()	Obtém um objeto BatteryReport que indica a carga, a capacidade e status da bateria ou agregação.

Eventos

ReportUpdated

Ocorre quando a carga, a capacidade ou o status de uma bateria é alterado.

Confira também

• Obter informações de bateria