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 전원에 연결된 노트북입니다. 이 경우 배터리 컨트롤러가 노트북 인클로저의 일부인 경우 배터리가 장치에 연결되지 않은 경우 배터리 개체를 만들 수 있습니다. 그러나 배터리 컨트롤러가 실제 배터리에 있는 경우 더 이상 운영 체제에 표시되지 않으므로 개별 배터리에 해당하는 Battery 개체를 만들 수 없습니다.

속성

AggregateBattery	디바이스에 연결된 모든 배터리 컨트롤러를 나타내는 Battery 개체를 가져옵니다.
DeviceId	개별 배터리 컨트롤러의 식별자(ID)를 가져옵니다.

메서드

FromIdAsync(String)	디바이스에 연결된 개별 배터리 컨트롤러를 나타내는 Battery 개체를 가져옵니다.
GetDeviceSelector()	디바이스에 연결된 모든 배터리 컨트롤러를 찾는 데 사용할 수 있는 AQS(고급 쿼리 구문) 문자열을 가져옵니다.
GetReport()	배터리 또는 집계의 충전, 용량 및 상태 나타내는 BatteryReport 개체를 가져옵니다.

이벤트

ReportUpdated

배터리의 충전, 용량 또는 상태 변경되면 발생합니다.

추가 정보

• 배터리 정보 가져오기