Battery クラス

定義

名前空間:

Windows.Devices.Power

デバイスに現在接続されているバッテリ コントローラーに関する情報を提供します。 詳細については、「 バッテリー情報を取得する」を参照してください。

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

継承

Object Platform::Object IInspectable Battery

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

このコンテキストでは、 デバイス はアプリが実行されているハードウェアを参照します。 バッテリ コントローラー は、物理バッテリとオペレーティング システムの間でインターフェイスするエレクトロニクスを指します。 バッテリー コントローラーは、デバイス マネージャーの [バッテリ] ノードの下に "バッテリー" として表示されます。

デバイスによっては、デバイスの実行中に物理バッテリーを取り外す場合があります。 たとえば、A/C 電源に接続されているノート PC などです。 その場合、バッテリー コントローラーがノート PC エンクロージャの一部であった場合は、デバイスにバッテリーが接続されていないときに Battery オブジェクトを作成する可能性があります。 ただし、バッテリ コントローラーが物理バッテリに存在する場合は、オペレーティング システムに表示されなくなり、個々のバッテリーに対応する Battery オブジェクトを作成できませんでした。

プロパティ

AggregateBattery	デバイスに接続されているすべてのバッテリ コントローラーを表す Battery オブジェクトを取得します。
DeviceId	個々のバッテリ コントローラーの識別子 (ID) を取得します。

メソッド

FromIdAsync(String)	デバイスに接続されている個々のバッテリ コントローラーを表す Battery オブジェクトを取得します。
GetDeviceSelector()	デバイスに接続されているすべてのバッテリ コントローラーを検索するために使用できる高度なクエリ構文 (AQS) 文字列を取得します。
GetReport()	バッテリーまたは集計の充電、容量、および状態を示す BatteryReport オブジェクトを取得します。

イベント

ReportUpdated

バッテリーの充電、容量、または状態が変化したときに発生します。

こちらもご覧ください

• バッテリー情報の取得