|
|
|
|
PowerStatus (Function) In french: EtatAlimentation
Warning
From version 26, this function is available for backward compatibility. Use the SysPowerStatus function.
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: " + PowerStatus(ChargePercentage) + " %")
Syntax
<Result> = PowerStatus(<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.
| RemainingLife | Remaining lifetime (in seconds) of battery. | TotalLife | Total lifetime (in seconds) of battery. |
<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: PowerStatus 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|