MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QRadioTunerControl Class Reference

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

 #include <QRadioTunerControl>

Inherits: QMediaControl.

This class was introduced in Qt Mobility 1.0.

Public Functions

~QRadioTunerControl ()
virtual QtMultimediaKit::AvailabilityError availabilityError () const = 0
virtual QRadioTuner::Band band () const = 0
virtual void cancelSearch () = 0
virtual QRadioTuner::Error error () const = 0
virtual QString errorString () const = 0
virtual int frequency () const = 0
virtual QPair<int, int> frequencyRange ( QRadioTuner::Band band ) const = 0
virtual int frequencyStep ( QRadioTuner::Band band ) const = 0
virtual bool isAvailable () const = 0
virtual bool isBandSupported ( QRadioTuner::Band band ) const = 0
virtual bool isMuted () const = 0
virtual bool isSearching () const = 0
virtual bool isStereo () const = 0
virtual void searchBackward () = 0
virtual void searchForward () = 0
virtual void setBand ( QRadioTuner::Band band ) = 0
virtual void setFrequency ( int frequency ) = 0
virtual void setMuted ( bool muted ) = 0
virtual void setStereoMode ( QRadioTuner::StereoMode mode ) = 0
virtual void setVolume ( int volume ) = 0
virtual int signalStrength () const = 0
virtual void start () = 0
virtual QRadioTuner::State state () const = 0
virtual QRadioTuner::StereoMode stereoMode () const = 0
virtual void stop () = 0
virtual int volume () const = 0
  • 29 public functions inherited from QObject

Signals

void bandChanged ( QRadioTuner::Band band )
void error ( QRadioTuner::Error error )
void frequencyChanged ( int frequency )
void mutedChanged ( bool muted )
void searchingChanged ( bool searching )
void signalStrengthChanged ( int strength )
void stateChanged ( QRadioTuner::State state )
void stereoStatusChanged ( bool stereo )
void volumeChanged ( int volume )

Protected Functions

QRadioTunerControl ( QObject * parent = 0 )
  • 7 protected functions inherited from QObject

Macros

QRadioTunerControl_iid

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables inherited from QObject

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.

This function was introduced in Qt Mobility 1.0.

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

Returns the frequency band a radio tuner is tuned to.

This function was introduced in Qt Mobility 1.0.

See also setBand().

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

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

This function was introduced in Qt Mobility 1.0.

void QRadioTunerControl::cancelSearch () [pure virtual]

Stops scanning for a signal.

This function was introduced in Qt Mobility 1.0.

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

Returns the error state of a radio tuner.

This function was introduced in Qt Mobility 1.0.

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

Signals that an error has occurred.

This function was introduced in Qt Mobility 1.0.

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

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

This function was introduced in Qt Mobility 1.0.

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

Returns the frequency a radio tuner is tuned to.

This function was introduced in Qt Mobility 1.0.

See also setFrequency().

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

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

This function was introduced in Qt Mobility 1.0.

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

Returns a frequency band's minimum and maximum frequency.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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

Returns true if the radio service is ready to use.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

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

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

This function was introduced in Qt Mobility 1.0.

void QRadioTunerControl::searchBackward () [pure virtual]

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

This function was introduced in Qt Mobility 1.0.

void QRadioTunerControl::searchForward () [pure virtual]

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

This function was introduced in Qt Mobility 1.0.

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

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

This function was introduced in Qt Mobility 1.0.

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.

This function was introduced in Qt Mobility 1.0.

See also band().

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

Sets the frequency a radio tuner is tuned to.

This function was introduced in Qt Mobility 1.0.

See also frequency().

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

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

This function was introduced in Qt Mobility 1.0.

See also isMuted().

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

Sets a radio tuner's stereo mode.

This function was introduced in Qt Mobility 1.0.

See also stereoMode() and QRadioTuner::StereoMode.

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

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

This function was introduced in Qt Mobility 1.0.

See also volume().

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

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

This function was introduced in Qt Mobility 1.0.

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

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

This function was introduced in Qt Mobility 1.0.

void QRadioTunerControl::start () [pure virtual]

Activate the radio device.

This function was introduced in Qt Mobility 1.0.

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

Returns the current radio tuner state.

This function was introduced in Qt Mobility 1.0.

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

Signals that the state of a radio tuner has changed.

This function was introduced in Qt Mobility 1.0.

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

Returns a radio tuner's stereo mode.

This function was introduced in Qt Mobility 1.0.

See also setStereoMode() and QRadioTuner::StereoMode.

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

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

This function was introduced in Qt Mobility 1.0.

void QRadioTunerControl::stop () [pure virtual]

Deactivate the radio device.

This function was introduced in Qt Mobility 1.0.

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

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

This function was introduced in Qt Mobility 1.0.

See also setVolume().

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

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

This function was introduced in Qt Mobility 1.0.

Macro Documentation

QRadioTunerControl_iid

com.nokia.Qt.QRadioTunerControl/1.0

Defines the interface name of the QRadioTunerControl class.