System.Machine.PowerStatus object
[The Windows Gadget Platform/Sidebar is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. ]
Defines the properties and events for the computer's power status.
Members
The System.Machine.PowerStatus object has these types of members:
Events
The System.Machine.PowerStatus object has these events.
| Event | Description |
|---|---|
| powerLineStatusChanged | Event fired when the computer's power supply state changes between plugged-in and battery-powered. |
Properties
The System.Machine.PowerStatus object has these properties.
| Property | Access type | Description |
|---|---|---|
| batteryCapacityRemaining |
Read-only |
Gets the remaining capacity of the computer battery in seconds. |
| batteryCapacityTotal |
Read-only |
Gets the total capacity of the computer battery in seconds. |
| batteryPercentRemaining |
Read-only |
Gets the remaining capacity of the computer battery as a percentage of total capacity. |
| batteryStatus |
Read-only |
Gets the charge state of the computer's battery. |
| isBatteryCharging |
Read-only |
Gets the battery charging status. |
| isPowerLineConnected |
Read-only |
Gets the power supply state. |
Requirements
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| End of client support |
Windows 7 |
| End of server support |
Windows Server 2008 |
| IDL |
|
| DLL |
|