diff -r 885c2596c964 -r 5d007b20cfd0 qtmobileextensions/src/sysinfo/xqsysinfo.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/qtmobileextensions/src/sysinfo/xqsysinfo.cpp Tue Aug 31 16:02:37 2010 +0300 @@ -0,0 +1,314 @@ +/* +* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* +* This program is free software: you can redistribute it and/or modify +* it under the terms of the GNU Lesser General Public License as published by +* the Free Software Foundation, version 2.1 of the License. +* +* This program is distributed in the hope that it will be useful, +* but WITHOUT ANY WARRANTY; without even the implied warranty of +* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +* GNU Lesser General Public License for more details. +* +* You should have received a copy of the GNU Lesser General Public License +* along with this program. If not, +* see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/". +* +* Description: +* +*/ + +#include "xqsysinfo.h" +#include "xqsysinfo_p.h" + +/*! + \class XQSysInfo + + \brief The XQSysInfo class is used to retrieve information about the phone (e.g. software version, free memory, IMEI, etc.) +*/ + +/*! + Constructs a XQSysInfo object with the given parent. +*/ +XQSysInfo::XQSysInfo(QObject* parent): + QObject(parent), d(new XQSysInfoPrivate(this)) +{ +} + +/*! + Destroys the XQSysInfo object. +*/ +XQSysInfo::~XQSysInfo() +{ + delete d; +} + +/*! + \enum XQSysInfo::Error + This enum defines the possible errors for a XQSysInfo object. +*/ +/*! \var XQSysInfo::Error XQSysInfo::NoError + No error occured. +*/ +/*! \var XQSysInfo::Error XQSysInfo::OutOfMemoryError + Not enough memory. +*/ +/*! \var XQSysInfo::Error XQSysInfo::IncorrectDriveError + Wrong drive letter. +*/ +/*! \var XQSysInfo::Error XQSysInfo::DriveNotFoundError + Drive cannot be found. +*/ +/*! \var XQSysInfo::Error XQSysInfo::UnknownError + Unknown error. +*/ + +/*! + \enum XQSysInfo::Drive + + This enum defines the possible drive letters to be used. +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveA + Drive A +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveB + Drive B +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveC + Drive C +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveD + Drive D +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveE + Drive E +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveF + Drive F +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveG + Drive G +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveH + Drive H +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveI + Drive I +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveJ + Drive J +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveK + Drive K +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveL + Drive L +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveM + Drive M +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveN + Drive N +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveO + Drive O +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveP + Drive P +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveQ + Drive Q +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveR + Drive R +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveS + Drive S +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveT + Drive T +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveU + Drive U +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveV + Drive V +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveW + Drive W +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveX + Drive X +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveY + Drive Y +*/ +/*! \var XQSysInfo::Drive XQSysInfo::DriveZ + Drive Z +*/ + +/*! + \enum XQSysInfo:Language + This enum defines the languages that are available + +*/ + +/*! + + \return Current language of the phone UI +*/ +XQSysInfo::Language XQSysInfo::currentLanguage() const +{ + return d->currentLanguage(); +} + +/*! + + \return International Mobile Equipment Identity (IMEI) unique identifier for the device. +*/ +QString XQSysInfo::imei() const +{ + return d->imei(); +} + +/*! + + \return International Mobile Subscriber Identity (IMSI) from the device's SIM card, +*/ +QString XQSysInfo::imsi() const +{ + return d->imsi(); +} + +/*! + + \return Firmware version of the device +*/ +QString XQSysInfo::softwareVersion() const +{ + return d->softwareVersion(); +} + +/*! + + \return Phone model +*/ +QString XQSysInfo::model() const +{ + return d->model(); +} + +/*! + \return Manufacturer of the phone +*/ +QString XQSysInfo::manufacturer() const +{ + return d->manufacturer(); +} + +/*! + \return Current battery level as a percentage, i.e. 0 to 100% +*/ +uint XQSysInfo::batteryLevel() const +{ + return d->batteryLevel(); +} + +/*! + \return Network signal strength as a percentage, i.e. 0 to 100% +*/ +int XQSysInfo::signalStrength() const +{ + return d->signalStrength(); +} + +/*! + NOTE: No implementation in the alpha release + + \return Version string for the device's browser +*/ +QString XQSysInfo::browserVersion() const +{ + return d->browserVersion(); +} + +/*! + + \param drive Drive letter as enumeration + \return Available disk space in bytes on the given drive +*/ +qlonglong XQSysInfo::diskSpace(XQSysInfo::Drive drive) const +{ + return d->diskSpace(drive); +} + +/*! + Helper function to check if the disk space on the given drive is in critical condition, i.e. very low + + \param drive Drive letter as enumeration + \return True, if memory is low on the given device, otherwise false +*/ +bool XQSysInfo::isDiskSpaceCritical(XQSysInfo::Drive drive) const +{ + return d->isDiskSpaceCritical(drive); +} + +/*! + Free RAM memory in bytes + + \return Free RAM memory in bytes +*/ +int XQSysInfo::memory() const +{ + return d->memory(); +} + +/*! + Checks if the specific feature is supported in the environment. See + + featureinfo.h File Reference + in the Symbian S60 SDK for a list of the feature ids. //insp: major, description of the error checking missing + + \param featureId Feature id + \return True, if the feature is supported, otherwise false +*/ +bool XQSysInfo::isSupported(int featureId) +{ + return XQSysInfoPrivate::isSupported(featureId); +} +/*! + \return Error code indicating the current error level +*/ +XQSysInfo::Error XQSysInfo::error() const +{ + return d->error(); +} + +/*! + Checks if the network is available + + \return True, if the network is available, otherwise false +*/ +bool XQSysInfo::isNetwork() const +{ + return d->isNetwork(); +} + +/*! + \fn void XQSysInfo::networkSignalChanged(ulong signalStrength) + + This signal is emitted when the signal strength changes. + + \param signalStrength New signal strength value + \sa signalStrength() +*/ + +/*! + \fn void XQSysInfo::batteryLevelChanged(uint batteryLevel) + + This signal is emitted when the battery level changes. + + \param batteryLevel New battery level + \sa batteryLevel() +*/