SysPowerStatus

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Windows management functions

SysBatteryOptimBackground

SysCacheExternalStorage

SysChangeEnvironment

SysChangeScreenResolution

SysColor

SysColorRes

SysDetectLockedSession

SysDeviceInfo

SysDir

SysDirExternalStorage

SysIconDisplayTooltip

SysListScreenOrientation

SysListScreenResolution

SysListVideoCard

SysMemoryExternalStorage

SysRemovableExternalStorage

SysStatusExternalStorage

SysStatusStorageCard

SysTheme

SysThumbnailAddButton

SysThumbnailDeleteAll

SysThumbnailDeleteButton

SysThumbnailModifyButton

New WINDEV Mobile 26 feature!

Battery
Management of errors
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

SysPowerStatus

In french: SysEtatAlimentation

Used to get various information about the battery (main or secondary) of the device on which the application is running.

Example

// 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:
Charging
True if the battery is charging,
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.
ACLineStatus
True if the device is plugged in,
False otherwise.
RemainingLife Remaining lifetime (in seconds) of battery.
Versions 23 and later
This constant is not available.
New in version 23
This constant is not available.
This constant is not available.
TotalLife Total lifetime (in seconds) of battery.
Versions 23 and later
This constant is not available.
New in version 23
This constant is not available.
This constant is not available.

<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.
Versions 23 and later
No information can be retrieved about the secondary battery. If <Battery> is set to False, <Result> will correspond to an empty string ("").
New in version 23
No information can be retrieved about the secondary battery. If <Battery> is set to False, <Result> will correspond to an empty string ("").
No information can be retrieved about the secondary battery. If <Battery> is set to False, <Result> will correspond to an empty string ("").

Remarks

Battery

Depending on the Mobile Device (Pocket PC) used, some information is not returned.
Some Mobile Devices are not equipped with batteries.
Versions 23 and later
No information can be retrieved about the secondary battery.
New in version 23
No information can be retrieved about the secondary battery.
No information can be retrieved about the secondary battery.
Versions 23 and later
The returned information is invalid in emulator mode.
New in version 23
The returned information is invalid in emulator mode.
The returned information is invalid in emulator mode.

Management of errors

Caution: SysPowerStatus returns no error code. To determine if this function has generated an error, use ErrorInfo with the errMessage constant.

Miscellaneous

To determine the battery status of the Mobile Device connected to the PC in a WINDEV application, use cePowerStatus.

Component: wp260ce.dll