QBandSelection Class Reference
[QtTelephonyModule]

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:

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.

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().