QRadioTunerControl Class

Member Function Documentation

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

Constructs a radio tuner control with the given parent.

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

Signals that the antenna has either been connected or disconnected as reflected with the connectionStatus.

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

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

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

Signals that an error has occurred.

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 error){ /* ... */ });

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

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

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

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

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

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

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

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

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

Signals that the state of a radio tuner has changed.

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

Signals that new station with frequency and stationId was found when scanning

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

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

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

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

[virtual] QRadioTunerControl::~QRadioTunerControl()

Destroys a radio tuner control.

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

Returns the frequency band a radio tuner is tuned to.

See also setBand().

[pure virtual] void QRadioTunerControl::cancelSearch()

Stops scanning for a signal.

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

Returns the error state of a radio tuner.

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

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

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

Returns the frequency a radio tuner is tuned to.

See also setFrequency().

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

Returns a frequency band's minimum and maximum frequency.

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

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

[virtual] bool QRadioTunerControl::isAntennaConnected() const

Identifies if there is an antenna connected to the device.

Returns true if there is a connected antenna, and false otherwise.

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

Identifies if a frequency band is supported.

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

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

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

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

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

Identifies if a radio tuner is currently scanning for signal.

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

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

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.

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

Starts a scan through the whole frequency band searching all stations with a specific searchMode.

[pure virtual] void QRadioTunerControl::searchBackward()

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

[pure virtual] void QRadioTunerControl::searchForward()

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

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

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

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

Sets the frequency a radio tuner is tuned to.

See also frequency().

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

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

See also isMuted().

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

Sets a radio tuner's stereo mode.

See also stereoMode() and QRadioTuner::StereoMode.

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

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

See also volume().

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

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

[pure virtual] void QRadioTunerControl::start()

Activate the radio device.

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

Returns the current radio tuner state.

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

Returns a radio tuner's stereo mode.

See also setStereoMode() and QRadioTuner::StereoMode.

[pure virtual] void QRadioTunerControl::stop()

Deactivate the radio device.

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

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

See also setVolume().