Home · All Classes · All Functions ·

QSystemDeviceInfo Class Reference

The QSystemDeviceInfo class provides access to device information from the system. More...

    #include <QSystemDeviceInfo>

Inherits QObject.


Public Types

enum BatteryStatus { NoBatteryLevel, BatteryCritical, BatteryVeryLow, BatteryLow, BatteryNormal }
enum InputMethod { Keys, Keypad, Keyboard, SingleTouch, MultiTouch, Mouse }
flags InputMethodFlags
enum PowerState { UnknownPower, BatteryPower, WallPower, WallPowerChargingBattery }
enum Profile { UnknownProfile, SilentProfile, NormalProfile, LoudProfile, ..., CustomProfile }
enum SimStatus { SimNotAvailable, SingleSimAvailable, DualSimAvailable, SimLocked }

Properties


Public Functions

QSystemDeviceInfo ( QObject * parent = 0 )
virtual ~QSystemDeviceInfo ()
int batteryLevel () const
QSystemDeviceInfo::BatteryStatus batteryStatus ()
QSystemDeviceInfo::PowerState currentPowerState ()
QSystemDeviceInfo::Profile currentProfile ()
QSystemDeviceInfo::InputMethodFlags inputMethodType ()
bool isDeviceLocked ()
QSystemDeviceInfo::SimStatus simStatus ()

Signals

void batteryLevelChanged ( int level )
void batteryStatusChanged ( QSystemDeviceInfo::BatteryStatus status )
void bluetoothStateChanged ( bool on )
void currentProfileChanged ( QSystemDeviceInfo::Profile profile )
void powerStateChanged ( QSystemDeviceInfo::PowerState state )

Static Public Members

QString imei ()
QString imsi ()
QString manufacturer ()
QString model ()
QString productName ()

Additional Inherited Members


Detailed Description

The QSystemDeviceInfo class provides access to device information from the system.


Member Type Documentation

enum QSystemDeviceInfo::BatteryStatus

This enum describes the status of the main battery.

ConstantValueDescription
QSystemDeviceInfo::NoBatteryLevel0Battery level undetermined.
QSystemDeviceInfo::BatteryCritical1Battery level is critical 3% or less.
QSystemDeviceInfo::BatteryVeryLow2Battery level is very low, 10% or less.
QSystemDeviceInfo::BatteryLow3Battery level is low 40% or less.
QSystemDeviceInfo::BatteryNormal4Battery level is above 40%.

enum QSystemDeviceInfo::InputMethod
flags QSystemDeviceInfo::InputMethodFlags

This enum describes the device method of user input.

ConstantValueDescription
QSystemDeviceInfo::Keys0x0000001Device has key/buttons.
QSystemDeviceInfo::Keypad0x0000002Device has keypad (1,2,3, etc).
QSystemDeviceInfo::Keyboard0x0000004Device has qwerty keyboard.
QSystemDeviceInfo::SingleTouch0x0000008Device has single touch screen.
QSystemDeviceInfo::MultiTouch0x0000010Device has muti touch screen.
QSystemDeviceInfo::Mouse0x0000020Device has a mouse.

The InputMethodFlags type is a typedef for QFlags<InputMethod>. It stores an OR combination of InputMethod values.

enum QSystemDeviceInfo::PowerState

This enum describes the power state:

ConstantValueDescription
QSystemDeviceInfo::UnknownPower0Power error.
QSystemDeviceInfo::BatteryPower1On battery power.
QSystemDeviceInfo::WallPower2On wall power.
QSystemDeviceInfo::WallPowerChargingBattery3On wall power and charging main battery.

enum QSystemDeviceInfo::Profile

This enum describes the current operating profile of the device or computer.

ConstantValueDescription
QSystemDeviceInfo::UnknownProfile0Profile unknown or error.
QSystemDeviceInfo::SilentProfile1Silent profile.
QSystemDeviceInfo::NormalProfile2Normal profile.
QSystemDeviceInfo::LoudProfile3Loud profile.
QSystemDeviceInfo::VibProfile4Vibrate profile.
QSystemDeviceInfo::OfflineProfile5Offline profile.
QSystemDeviceInfo::PowersaveProfile6Powersave profile.
QSystemDeviceInfo::CustomProfile7Custom profile.

enum QSystemDeviceInfo::SimStatus

This enum describes the status is the sim card or cards.

ConstantValueDescription
QSystemDeviceInfo::SimNotAvailable0SIM is not available on this device.
QSystemDeviceInfo::SingleSimAvailable1One SIM card is available on this.
QSystemDeviceInfo::DualSimAvailable2Two SIM cards are available on this device.
QSystemDeviceInfo::SimLocked3Device has SIM lock enabled.


Property Documentation

batteryLevel : const int

This property holds the battery level.

Returns the battery charge level as percentage 1 - 100 scale.

Access functions:

int batteryLevel () const

batteryStatus : const BatteryStatus

This property holds the battery status.

Returns the battery charge status.

Access functions:

QSystemDeviceInfo::BatteryStatus batteryStatus ()

currentPowerState : const PowerState

This property holds the power state.

Gets the current QSystemDeviceInfo::currentPowerState state.

Access functions:

QSystemDeviceInfo::PowerState currentPowerState ()

currentProfile : const Profile

This property holds the device profile Gets the current QSystemDeviceInfo::currentProfile device profile.

Access functions:

QSystemDeviceInfo::Profile currentProfile ()

imei : const QString

This property holds the IMEI.

Returns the International Mobile Equipment Identity (IMEI), or a null QString in the case of none.

Access functions:

QString imei ()

imsi : const QString

This property holds the IMSI.

Returns the International Mobile Subscriber Identity (IMSI), or a null QString in the case of none.

Access functions:

QString imsi ()

inputMethodType : const InputMethodFlags

This property holds the supported inputmethods.

Returns the QSystemDeviceInfo::InputMethodFlags InputMethodType that the system uses.

Access functions:

QSystemDeviceInfo::InputMethodFlags inputMethodType ()

isDeviceLocked : const bool

This property holds device lock.

Returns true if the device is locked, otherwise false.

Access functions:

bool isDeviceLocked ()

manufacturer : const QString

This property holds the manufacture's name.

Returns the name of the manufacturer of this device. In the case of desktops, the name of the vendor of the motherboard.

Access functions:

QString manufacturer ()

model : const QString

This property holds the model name.

Returns the model information of the device. In the case of desktops where no model information is present, the CPU architect, such as i686, and machine type, such as Server, Desktop or Laptop.

Access functions:

QString model ()

productName : const QString

This property holds the product name.

Returns the product name of the device. In the case where no product information is available,

Access functions:

QString productName ()

simStatus : const SimStatus

This property holds the status of the sim card. Returns the QSystemDeviceInfo::simStatus status of SIM card.

Access functions:

QSystemDeviceInfo::SimStatus simStatus ()

Member Function Documentation

QSystemDeviceInfo::QSystemDeviceInfo ( QObject * parent = 0 )

Constructs a QSystemDeviceInfo with the given parent.

QSystemDeviceInfo::~QSystemDeviceInfo ()   [virtual]

Destroys the QSystemDeviceInfo object.

void QSystemDeviceInfo::batteryLevelChanged ( int level )   [signal]

This signal is emitted when battery level has changed. level is the new level.

void QSystemDeviceInfo::batteryStatusChanged ( QSystemDeviceInfo::BatteryStatus status )   [signal]

This signal is emitted when battery status has changed. status is the new status.

void QSystemDeviceInfo::bluetoothStateChanged ( bool on )   [signal]

This signal is emitted whenever bluetooth state changes, specified by on.

void QSystemDeviceInfo::currentProfileChanged ( QSystemDeviceInfo::Profile profile )   [signal]

This signal is emitted whenever the network profile changes, specified by profile.

void QSystemDeviceInfo::powerStateChanged ( QSystemDeviceInfo::PowerState state )   [signal]

This signal is emitted when the power state has changed, such as when a phone gets plugged qint32o the wall. state is the new power state.


Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.0