Qt 5.11 | Qt Multimedia | C++ Classes | QRadioTunerControl

Qt 5.11.3 Reference Documentation

# QRadioTunerControl Class

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

Header: | #include <QRadioTunerControl>
qmake: | QT += multimedia
Inherits: | QMediaControl

- List of all members, including inherited members

## Public Functions

virtual | ~QRadioTunerControl()
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 b) const = 0
virtual int | frequencyStep(QRadioTuner::Band b) const = 0
virtual bool | isAntennaConnected() const
virtual bool | isBandSupported(QRadioTuner::Band b) const = 0
virtual bool | isMuted() const = 0
virtual bool | isSearching() const = 0
virtual bool | isStereo() const = 0
virtual void | searchAllStations(QRadioTuner::SearchMode searchMode = QRadioTuner::SearchFast) = 0
virtual void | searchBackward() = 0
virtual void | searchForward() = 0
virtual void | setBand(QRadioTuner::Band b) = 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

## Signals

void | antennaConnectedChanged(bool connectionStatus)
void | bandChanged(QRadioTuner::Band band)
void | error(QRadioTuner::Error err)
void | frequencyChanged(int frequency)
void | mutedChanged(bool muted)
void | searchingChanged(bool searching)
void | signalStrengthChanged(int signalStrength)
void | stateChanged(QRadioTuner::State state)
void | stationFound(int frequency, QString stationId)
void | stereoStatusChanged(bool stereo)
void | volumeChanged(int volume)

## Protected Functions

| QRadioTunerControl(QObject *parent = nullptr)

## Macros

| QRadioTunerControl_iid

## 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 `org.qt-project.qt.radiotunercontrol/5.0` as defined in QRadioTunerControl_iid.

See also QMediaService::requestControl() and QRadioTuner.

## Member Function Documentation

### `[protected]` QRadioTunerControl::QRadioTunerControl(QObject *parent = nullptr)

Constructs a radio tuner control with the given parent.

### `[virtual]` QRadioTunerControl::~QRadioTunerControl()

Destroys a radio tuner control.

### `[signal]` void QRadioTunerControl::antennaConnectedChanged(bool connectionStatus)

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

See also setBand().

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

### `[pure virtual]` void QRadioTunerControl::cancelSearch()

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

### `[signal]` void QRadioTunerControl::error(QRadioTuner::Error err)

Note: Signal error is overloaded in this class. To connect to this signal by using the function pointer syntax, Qt provides a convenient helper for obtaining the function pointer as shown in this example:

      connect(radioTunerControl, QOverload<QRadioTuner::Error>::of(&QRadioTunerControl::error),
          [=](QRadioTuner::Error err){ /* ... */ });

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

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

See also setFrequency().

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

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

### `[pure virtual]` int QRadioTunerControl::frequencyStep(QRadioTuner::Band b) const

### `[virtual]` bool QRadioTunerControl::isAntennaConnected() const

### `[pure virtual]` bool QRadioTunerControl::isBandSupported(QRadioTuner::Band b) const

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

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

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

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

### `[pure virtual]` void QRadioTunerControl::searchAllStations(QRadioTuner::SearchMode searchMode = QRadioTuner::SearchFast)

### `[pure virtual]` void QRadioTunerControl::searchBackward()

### `[pure virtual]` void QRadioTunerControl::searchForward()

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

### `[pure virtual]` void QRadioTunerControl::setBand(QRadioTuner::Band b)

See also band().

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

See also frequency().

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

See also isMuted().

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

See also stereoMode().

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

See also volume().

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

### `[signal]` void QRadioTunerControl::signalStrengthChanged(int signalStrength)

### `[pure virtual]` void QRadioTunerControl::start()

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

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

### `[signal]` void QRadioTunerControl::stationFound(int frequency, QString stationId)

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

See also setStereoMode().

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

### `[pure virtual]` void QRadioTunerControl::stop()

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

See also setVolume().

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

## Macro Documentation

### QRadioTunerControl_iid

`org.qt-project.qt.radiotunercontrol/5.0`

Defines the interface name of the QRadioTunerControl class.