内容

• 公共类型
• 特性
• 公共函数
• 重实现公共函数
• 公共槽
• 信号
• 重实现保护函数
• 详细描述

QRadioData Class

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 }

特性

alternativeFrequenciesEnabled : bool programType : const ProgramType programTypeName : const QString

radioText : const QString stationId : const QString stationName : const QString

• 1 特性继承自 QObject

公共函数

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

重实现公共函数

virtual QMediaObject *

mediaObject () const override

• 32 公共函数继承自 QObject
• 1 公共函数继承自 QMediaBindableInterface

公共槽

void	setAlternativeFrequenciesEnabled (bool enabled )

• 1 公共槽继承自 QObject

信号

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 )

• 2 信号继承自 QObject

重实现保护函数

virtual bool

setMediaObject (QMediaObject * mediaObject ) override

• 9 保护函数继承自 QObject
• 1 保护函数继承自 QMediaBindableInterface

额外继承成员

• 11 静态公共成员继承自 QObject
• 9 保护函数继承自 QObject
• 1 保护函数继承自 QMediaBindableInterface

详细描述

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

访问函数：

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 = Q_NULLPTR)

Constructs a radio data based on a mediaObject and parent .

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 .

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 在此类中是重载。要使用函数指针句法连接到此信号，必须在静态铸造中指定信号类型，如此范例所示：

connect(radioData, static_cast<void(QRadioData::*)(QRadioData::Error)>(&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 .