Home · All Classes · Annotated · Functions

QPowerStatus Class Reference

The QPowerStatus class represents a snapshot of the systems power status at a given time. More...

#include <QPowerStatus>

List of all members, including inherited members

Public Types

enum ACStatus { Offline, Online, Backup, Unknown }
enum BatteryStatus { High, Low, VeryLow, Critical, Charging, NotPresent }

Public Functions

QPowerStatus ()
ACStatus acStatus () const
BatteryStatus backupBatteryStatus () const
bool batteryPercentAccurate () const
int batteryPercentRemaining () const
BatteryStatus batteryStatus () const
int batteryTimeRemaining () const
bool operator!= ( const QPowerStatus & ps )

Detailed Description

The QPowerStatus class represents a snapshot of the systems power status at a given time.

An updated status can be obtained by calling QPowerStatusManager::readStatus().

Member Type Documentation

enum QPowerStatus::ACStatus

Constant	Value	Description
`QPowerStatus::Offline`	`0`	the device is running on battery
`QPowerStatus::Online`	`1`	the device is powered by an external power source
`QPowerStatus::Backup`	`2`	the device is running on backup power
`QPowerStatus::Unknown`	`3`	status is unknown

enum QPowerStatus::BatteryStatus

Constant	Value	Description
`QPowerStatus::High`	`0x01`	battery is fully charged
`QPowerStatus::Low`	`0x02`	the battery level is low
`QPowerStatus::VeryLow`	`0x04`	very low battery level
`QPowerStatus::Critical`	`0x08`	critical battery level
`QPowerStatus::Charging`	`0x10`	the battery is being charged
`QPowerStatus::NotPresent`	`0x20`	the status if the battery is unknown

Member Function Documentation

QPowerStatus::QPowerStatus ()

Constructs a QPowerStatus object.

ACStatus QPowerStatus::acStatus () const

Returns the AC status of the device.

BatteryStatus QPowerStatus::backupBatteryStatus () const

Returns the status of the backup battery.

bool QPowerStatus::batteryPercentAccurate () const

Returns true if the value returned by batteryPercentRemaining() reflects the true value of remaining battery. If for instance APM is not available the return value of remaining battery does not reflect the true value.

int QPowerStatus::batteryPercentRemaining () const

Returns the remaining battery life (percentage of charge).

BatteryStatus QPowerStatus::batteryStatus () const

Returns the battery status of the device.

int QPowerStatus::batteryTimeRemaining () const

Returns the remaining battery life in seconds.

bool QPowerStatus::operator!= ( const QPowerStatus & ps )

Returns true if this power status is not equal to ps, otherwise returns false.

Trademarks

Qtopia 4.1.7