Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions codeless banner

QBandSelection Class Reference
[QtTelephonyModule]

The QBandSelection class provides an interface to select a GSM band for the phone to operate on. More...

    #include <QBandSelection>

Inherits QCommInterface.

Public Types

Public Functions

Public Slots

Signals

Additional Inherited Members


Detailed Description

The QBandSelection class provides an interface to select a GSM band for the phone to operate on.

Bands are identified by string identifiers such as the following:

GSM 850GSM at 850 MHz
GSM 900GSM at 900 MHz
GSM 1800DCS at 1800 MHz
GSM 1900PCS at 1900 MHz
Dual 900/1800Dual 900 MHz and 1800 MHz bands
Dual 850/1900Dual 950 MHz and 1900 MHz bands

Telephony services should report dual bands separately from the single constituent bands, to allow the user to select either a specific band, or one of a set of supported bands.

Not all modems support band selection. The available() method should be used by client applications to determine if band selection is possible.

See also QCommInterface.


Member Type Documentation

enum QBandSelection::BandMode

This enum defines the mode of band selection to be used.

ConstantValueDescription
QBandSelection::Automatic0Use an explicit band selection if possible, but fall back to any available band otherwise.
QBandSelection::Manual1Use only the explicitly specified band.


Member Function Documentation

QBandSelection::QBandSelection ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )

Construct a new band selection object for service and attach it to parent. The object will be created in client mode if mode is Client, or server mode otherwise.

If service is empty, this class will use the first available service that supports band selection. If there is more than one service that supports band selection, the caller should enumerate them with QCommServiceManager::supports() and create separate QBandSelection objects for each.

See also QCommServiceManager::supports().

QBandSelection::~QBandSelection ()

Destroy this band selection object.

void QBandSelection::band ( QBandSelection::BandMode mode, const QString & value )   [signal]

Signal that is emitted in response to requestBand(), to report the currently selected mode and band value.

See also setBand() and requestBand().

void QBandSelection::bands ( const QStringList & list )   [signal]

Signal that is emitted to report the supported list of bands.

See also requestBands().

void QBandSelection::requestBand ()   [virtual slot]

Request the currently selected band. The result is reported via the band() signal.

See also band() and requestBands().

void QBandSelection::requestBands ()   [virtual slot]

Request a list of all bands that can be selected from. The result is reported via the bands() signal.

See also bands() and requestBand().

void QBandSelection::setBand ( QBandSelection::BandMode mode, const QString & value )   [virtual slot]

Sets the current band mode and value. If value is null, and mode is Automatic, then any available band will be used. The result of setting the band is reported via the setBandResult() signal.

See also band(), setBandResult(), and requestBand().

void QBandSelection::setBandResult ( QTelephony::Result result )   [signal]

Signal that is emitted to report the result of calling setBand().

See also setBand().


Copyright © 2009 Nokia Trademarks
Qt Extended 4.4.3