PowerStatus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Specific Mobile functions

Phone management functions

Android: The different types of notifications

App Tracking Transparency - Activity tracking

AppleAdvertisingIdentifier

AppleID

AppleRequestTrackingAuthorizationAsynchronous

AppleSignIn

AppleTrackingAuthorizationStatus

Connected objects: Android Wear

Constants for phone management

GetTheme

LEDSwitchOff

LEDSwitchOn

MobileNetworkConnectionInfo

NotifPushListInvalidIdentifiers

NotifPushProcedure

NotifPushSend

Notification

Phone management functions

PowerStatus

Push notification

Push notification: Android configuration (Firebase)

Push notification: Android configuration (Google Cloud Messaging)

Push notification: iOS configuration

Push notifications: format of notifications (Android and iOS)

WLanguage procedure called by AppleSignIn

iOSExcludeFileFromiCloud

Battery
Handling errors

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

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.

Versions 23 and later

This function is now available in Android widget mode.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications (from version 230042).

New in version 23

This function is now available in Android widget mode.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications (from version 230042).

This function is now available in Android widget mode.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications (from version 230042).

Example

// 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.
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

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.

Handling errors

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