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

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

適用対象

こちらもご覧ください