Used to get various information about the battery (main or secondary) of the device on which the application is running.
// Status of main battery?
Info("The battery is loaded at: " + SysPowerStatus(ChargePercentage) + " %")
Syntax
<Result> = SysPowerStatus(<Type of information> [, <Battery>])
<Result>: Integer or boolean according to the type of information
- Requested information,
- Empty string ("") if the requested information is not available.
<Type of information>: Integer constant
Specifies the type of requested information:
| |
| ACLineStatus | - True if the device is plugged in,
- False otherwise.
|
| ChargeLevel | Charge level of battery:- 0: battery not found.
- 1: high level.
- 2: low level.
- 3: critical level.
|
| ChargePercentage | Percentage of battery load. |
| Charging | - True if the battery is charging,
- False otherwise.
|
<Battery>: Optional boolean
- True (by default) to get information about the main battery of device,
- False to get information about the secondary battery of device.
Remarks
No information can be retrieved about the secondary battery. - The returned information is invalid in emulator mode.
Caution:
SysPowerStatus returns no error code. To determine if this function has generated an error, use
ErrorInfo with the
errMessage constant.
Business / UI classification: Business Logic
Component: wd270android.aar