Home · All Classes · All Functions ·

QRadioTunerControl Class Reference

The QRadioTunerControl class provides access to the radio tuning functionality of a QMediaService. More...

    #include <QRadioTunerControl>

This class is under development and is subject to change.

Inherits QMediaControl.

Public Functions

Signals

Protected Functions

Macros

Additional Inherited Members


Detailed Description

The QRadioTunerControl class provides access to the radio tuning functionality of a QMediaService.

If a QMediaService can tune an analog radio device it will implement QRadioTunerControl. This control provides a means to tune a radio device to a specific frequency as well as search forwards and backwards for a signal.

The functionality provided by this control is exposed to application code through the QRadioTuner class.

The interface name of QRadioTunerControl is com.nokia.Qt.QRadioTunerControl/1.0 as defined in QRadioTunerControl_iid.

See also QMediaService::requestControl() and QRadioTuner.


Member Function Documentation

QRadioTunerControl::QRadioTunerControl ( QObject * parent = 0 )   [protected]

Constructs a radio tuner control with the given parent.

QRadioTunerControl::~QRadioTunerControl ()

Destroys a radio tuner control.

QtMultimediaKit::AvailabilityError QRadioTunerControl::availabilityError () const   [pure virtual]

Returns the error state of the radio service.

QRadioTuner::Band QRadioTunerControl::band () const   [pure virtual]

Returns the frequency band a radio tuner is tuned to.

See also setBand().

void QRadioTunerControl::bandChanged ( QRadioTuner::Band band )   [signal]

Signals that the frequency band a radio tuner is tuned to has changed.

void QRadioTunerControl::cancelSearch ()   [pure virtual]

Stops scanning for a signal.

QRadioTuner::Error QRadioTunerControl::error () const   [pure virtual]

Returns the error state of a radio tuner.

void QRadioTunerControl::error ( QRadioTuner::Error error )   [signal]

Signals that an error has occured.

QString QRadioTunerControl::errorString () const   [pure virtual]

Returns a string describing a radio tuner's error state.

int QRadioTunerControl::frequency () const   [pure virtual]

Returns the frequency a radio tuner is tuned to.

See also setFrequency().

void QRadioTunerControl::frequencyChanged ( int frequency )   [signal]

Signals that the frequency a radio tuner is tuned to has changed.

QPair<int, int> QRadioTunerControl::frequencyRange ( QRadioTuner::Band band ) const   [pure virtual]

Returns a frequency band's minimum and maximum frequency.

int QRadioTunerControl::frequencyStep ( QRadioTuner::Band band ) const   [pure virtual]

Returns the number of Hertz to increment the frequency by when stepping through frequencies within a given band.

bool QRadioTunerControl::isAvailable () const   [pure virtual]

Returns true if the radio service is ready to use.

bool QRadioTunerControl::isBandSupported ( QRadioTuner::Band band ) const   [pure virtual]

Identifies if a frequency band is supported.

Returns true if the band is supported, and false if it is not.

bool QRadioTunerControl::isMuted () const   [pure virtual]

Identifies if a radio tuner's audio output is muted.

Returns true if the audio is muted, and false if it is not.

bool QRadioTunerControl::isSearching () const   [pure virtual]

Identifies if a radio tuner is currently scanning for signal.

Returns true if the tuner is scanning, and false if it is not.

bool QRadioTunerControl::isStereo () const   [pure virtual]

Identifies if a radio tuner is receiving a stereo signal.

Returns true if the tuner is receiving a stereo signal, and false if it is not.

void QRadioTunerControl::mutedChanged ( bool muted )   [signal]

Signals that the muted state of a radio tuner's audio output has changed.

void QRadioTunerControl::searchBackward ()   [pure virtual]

Starts a backwards scan for a signal, starting from the current frequency().

void QRadioTunerControl::searchForward ()   [pure virtual]

Starts a forward scan for a signal, starting from the current frequency().

void QRadioTunerControl::searchingChanged ( bool searching )   [signal]

Signals that the searching state of a radio tuner has changed.

void QRadioTunerControl::setBand ( QRadioTuner::Band band )   [pure virtual]

Sets the frequecy band a radio tuner is tuned to.

Changing the frequency band will reset the frequency to the minimum frequency of the new band.

See also band().

void QRadioTunerControl::setFrequency ( int frequency )   [pure virtual]

Sets the frequency a radio tuner is tuned to.

See also frequency().

void QRadioTunerControl::setMuted ( bool muted )   [pure virtual]

Sets the muted state of a radio tuner's audio output.

See also isMuted().

void QRadioTunerControl::setStereoMode ( QRadioTuner::StereoMode mode )   [pure virtual]

Sets a radio tuner's stereo mode.

See also stereoMode() and QRadioTuner::StereoMode.

void QRadioTunerControl::setVolume ( int volume )   [pure virtual]

Sets the percentage volume of a radio tuner's audio output.

See also volume().

int QRadioTunerControl::signalStrength () const   [pure virtual]

Return a radio tuner's current signal strength as a percentage.

void QRadioTunerControl::signalStrengthChanged ( int strength )   [signal]

Signals that the percentage strength of the signal received by a radio tuner has changed.

void QRadioTunerControl::start ()   [pure virtual]

Activate the radio device.

QRadioTuner::State QRadioTunerControl::state () const   [pure virtual]

Returns the current radio tuner state.

void QRadioTunerControl::stateChanged ( QRadioTuner::State state )   [signal]

Signals that the state of a radio tuner has changed.

QRadioTuner::StereoMode QRadioTunerControl::stereoMode () const   [pure virtual]

Returns a radio tuner's stereo mode.

See also setStereoMode() and QRadioTuner::StereoMode.

void QRadioTunerControl::stereoStatusChanged ( bool stereo )   [signal]

Signals that the stereo state of a radio tuner has changed.

void QRadioTunerControl::stop ()   [pure virtual]

Deactivate the radio device.

int QRadioTunerControl::volume () const   [pure virtual]

Returns the volume of a radio tuner's audio output as a percentage.

See also setVolume().

void QRadioTunerControl::volumeChanged ( int volume )   [signal]

Signals that the percentage volume of radio tuner's audio output has changed.


Macro Documentation

QRadioTunerControl_iid

com.nokia.Qt.QRadioTunerControl/1.0

Defines the interface name of the QRadioTunerControl class.


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