Partager via


Battery Classe

Définition

Fournit des informations sur un contrôleur de batterie actuellement connecté à l’appareil. Pour plus d’informations, consultez Obtenir des informations sur la batterie.

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
Héritage
Object Platform::Object IInspectable Battery
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Dans ce contexte, l’appareil fait référence au matériel sur lequel votre application s’exécute. Le contrôleur de batterie fait référence à l’électronique qui interface entre la batterie physique et le système d’exploitation. Un contrôleur de batterie apparaît dans Gestionnaire de périphériques sous la forme « Batterie » sous le nœud Batteries.

Selon l’appareil, il peut être possible de retirer la batterie physique pendant que l’appareil reste en cours d’exécution. Par exemple, un ordinateur portable connecté à l’alimentation A/C. Dans ce cas, si le contrôleur de batterie faisait partie du boîtier de l’ordinateur portable, vous pouvez potentiellement créer un objet Batterie quand aucune batterie n’est connectée à l’appareil. Toutefois, si le contrôleur de batterie réside sur la batterie physique, il n’est plus visible par le système d’exploitation et vous ne pouvez donc pas créer un objet Batterie correspondant pour une batterie individuelle.

Propriétés

AggregateBattery

Obtient un objet Battery qui représente tous les contrôleurs de batterie connectés à l’appareil.

DeviceId

Obtient l’identificateur (ID) d’un contrôleur de batterie individuel.

Méthodes

FromIdAsync(String)

Obtient un objet Battery qui représente un contrôleur de batterie individuel connecté à l’appareil.

GetDeviceSelector()

Obtient une chaîne AQS (Advanced Query Syntax) qui peut être utilisée pour rechercher tous les contrôleurs de batterie connectés à l’appareil.

GetReport()

Obtient un objet BatteryReport qui indique la charge, la capacité et status de la batterie ou de l’agrégat.

Événements

ReportUpdated

Se produit lorsque la charge, la capacité ou la status d’une batterie change.

S’applique à

Voir aussi