就业培训     下载中心     Wiki     联络 登录   注册
  1. 首页
  2. Qt 5.12.12
  3. Qt Multimedia
  4. C++ 类
  5. QRadioData

内容

QRadioData Class

The QRadioData class provides interfaces to the RDS functionality of the system radio. 更多...

头： #include <QRadioData>
qmake: QT += multimedia
继承： QObject and QMediaBindableInterface

公共类型

enum Error { NoError, ResourceError, OpenError, OutOfRangeError }
enum ProgramType { Undefined, News, CurrentAffairs, Information, ..., College }

特性

公共函数

QRadioData (QMediaObject * mediaObject , QObject * parent = nullptr)
virtual ~QRadioData ()
QMultimedia::AvailabilityStatus availability () const
QRadioData::Error error () const
QString errorString () const
bool isAlternativeFrequenciesEnabled () const
QRadioData::ProgramType programType () const
QString programTypeName () const
QString radioText () const
QString stationId () const
QString stationName () const

重实现公共函数

virtual QMediaObject * mediaObject () const override

公共槽

void setAlternativeFrequenciesEnabled (bool enabled )

信号

void alternativeFrequenciesEnabledChanged (bool enabled )
void error (QRadioData::Error error )
void programTypeChanged (QRadioData::ProgramType programType )
void programTypeNameChanged (QString programTypeName )
void radioTextChanged (QString radioText )
void stationIdChanged (QString stationId )
void stationNameChanged (QString stationName )

静态公共成员

const QMetaObject staticMetaObject

重实现保护函数

virtual bool setMediaObject (QMediaObject * mediaObject ) override

保护变量

QRadioDataPrivate * d_ptr

详细描述

The QRadioData class provides interfaces to the RDS functionality of the system radio.

The radio data object will emit signals for any changes in radio data. You can enable or disable alternative frequency with setAlternativeFrequenciesEnabled ().

You can get a QRadioData instance fromt the radioData property from a QRadioTuner 实例。 

radio = new QRadioTuner;
radioData = radio->radioData();

Alternatively, you can pass an instance of QRadioTuner to the constructor to QRadioData .

另请参阅 无线电概述 .

成员类型文档编制

enum QRadioData:: Error

Enumerates radio data error conditions.

常量 值 描述
QRadioData::NoError 0 没有出现错误。
QRadioData::ResourceError 1 There is no radio service available.
QRadioData::OpenError 2 Unable to open radio device.
QRadioData::OutOfRangeError 3 An attempt to set a frequency or band that is not supported by radio device.

enum QRadioData:: ProgramType

This property holds the type of the currently playing program as transmitted by the radio station. The value can be any one of the values defined in the table below.

常量 值
QRadioData::Undefined 0
QRadioData::News 1
QRadioData::CurrentAffairs 2
QRadioData::Information 3
QRadioData::Sport 4
QRadioData::Education 5
QRadioData::Drama 6
QRadioData::Culture 7
QRadioData::Science 8
QRadioData::Varied 9
QRadioData::PopMusic 10
QRadioData::RockMusic 11
QRadioData::EasyListening 12
QRadioData::LightClassical 13
QRadioData::SeriousClassical 14
QRadioData::OtherMusic 15
QRadioData::Weather 16
QRadioData::Finance 17
QRadioData::ChildrensProgrammes 18
QRadioData::SocialAffairs 19
QRadioData::Religion 20
QRadioData::PhoneIn 21
QRadioData::Travel 22
QRadioData::Leisure 23
QRadioData::JazzMusic 24
QRadioData::CountryMusic 25
QRadioData::NationalMusic 26
QRadioData::OldiesMusic 27
QRadioData::FolkMusic 28
QRadioData::Documentary 29
QRadioData::AlarmTest 30
QRadioData::Alarm 31
QRadioData::Talk 32
QRadioData::ClassicRock 33
QRadioData::AdultHits 34
QRadioData::SoftRock 35
QRadioData::Top40 36
QRadioData::Soft 37
QRadioData::Nostalgia 38
QRadioData::Classical 39
QRadioData::RhythmAndBlues 40
QRadioData::SoftRhythmAndBlues 41
QRadioData::Language 42
QRadioData::ReligiousMusic 43
QRadioData::ReligiousTalk 44
QRadioData::Personality 45
QRadioData::Public 46
QRadioData::College 47

特性文档编制

alternativeFrequenciesEnabled : bool

Is Alternative Frequency currently enabled

访问函数：

bool isAlternativeFrequenciesEnabled () const
void setAlternativeFrequenciesEnabled (bool enabled )

通知程序信号：

void alternativeFrequenciesEnabledChanged (bool enabled )

programType : const ProgramType

Current Program Type

访问函数：

QRadioData::ProgramType programType () const

通知程序信号：

void programTypeChanged (QRadioData::ProgramType programType )

programTypeName : const QString

Current Program Type Name

访问函数：

QString programTypeName () const

通知程序信号：

void programTypeNameChanged (QString programTypeName )

radioText : const QString

Current Radio Text

访问函数：

QString radioText () const

通知程序信号：

void radioTextChanged (QString radioText )

stationId : const QString

Current Program Identification

访问函数：

QString stationId () const

通知程序信号：

void stationIdChanged (QString stationId )

stationName : const QString

Current Program Service

访问函数：

QString stationName () const

通知程序信号：

void stationNameChanged (QString stationName )

成员函数文档编制

QRadioData:: QRadioData ( QMediaObject * mediaObject , QObject * parent = nullptr)

Constructs a radio data based on a mediaObject and parent .

The mediaObject should be an instance of QRadioTuner . It is preferable to use the radioData property on a QRadioTuner instance to get an instance of QRadioData .

During construction, this class is bound to the mediaObject 使用 bind() 方法。

[虚拟] QRadioData:: ~QRadioData ()

Destroys a radio data.

[signal] void QRadioData:: alternativeFrequenciesEnabledChanged ( bool enabled )

Signals that automatically tuning to alternative frequencies has been enabled or disabled according to enabled .

注意： 通知程序信号对于特性 alternativeFrequenciesEnabled .

QMultimedia::AvailabilityStatus QRadioData:: availability () const

Returns the availability of the radio data service.

A long as there is a media service which provides radio functionality, then the availability will be that of the radio tuner .

QRadioData::Error QRadioData:: error () const

Returns the error state of a radio data.

另请参阅 errorString ().

[signal] void QRadioData:: error ( QRadioData::Error error )

Signals that an error 出现。

注意： 信号 error 在此类中被重载。通过使用函数指针句法连接到此信号，Qt 提供用于获得如此范例展示的函数指针的方便帮助程序： 

connect(radioData, QOverload<QRadioData::Error>::of(&QRadioData::error),
    [=](QRadioData::Error error){ /* ... */ });

QString QRadioData:: errorString () const

Returns a description of a radio data's error state.

另请参阅 error ().

[override virtual] QMediaObject *QRadioData:: mediaObject () const

重实现自 QMediaBindableInterface::mediaObject ().

另请参阅 setMediaObject ().

[signal] void QRadioData:: programTypeChanged ( QRadioData::ProgramType programType )

Signals that the Program Type code has changed to programType

注意： 通知程序信号对于特性 programType .

[signal] void QRadioData:: programTypeNameChanged ( QString programTypeName )

Signals that the Program Type Name has changed to programTypeName

注意： 通知程序信号对于特性 programTypeName .

[signal] void QRadioData:: radioTextChanged ( QString radioText )

Signals that the Radio Text property has changed to radioText

注意： 通知程序信号对于特性 radioText .

[override virtual protected] bool QRadioData:: setMediaObject ( QMediaObject * mediaObject )

重实现自 QMediaBindableInterface::setMediaObject ().

另请参阅 mediaObject ().

[signal] void QRadioData:: stationIdChanged ( QString stationId )

Signals that the Program Identification code has changed to stationId

注意： 通知程序信号对于特性 stationId .

[signal] void QRadioData:: stationNameChanged ( QString stationName )

Signals that the Program Service has changed to stationName

注意： 通知程序信号对于特性 stationName .