QMetaDataReaderControl Class

The QMetaDataReaderControl class provides read access to the meta-data of a QMediaService's media. More...

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

Public Functions

virtual ~QMetaDataReaderControl()
virtual QStringList availableMetaData() const = 0
virtual bool isMetaDataAvailable() const = 0
virtual QVariant metaData(const QString &key) const = 0
  • 31 public functions inherited from QObject

Signals

void metaDataAvailableChanged(bool available)
void metaDataChanged()
void metaDataChanged(const QString &key, const QVariant &value)

Static Public Members

const QMetaObject staticMetaObject
  • 9 static public members inherited from QObject

Protected Functions

QMetaDataReaderControl(QObject *parent = nullptr)
  • 9 protected functions inherited from QObject

Macros

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject

Detailed Description

The QMetaDataReaderControl class provides read access to the meta-data of a QMediaService's media.

If a QMediaService can provide read or write access to the meta-data of its current media it will implement QMetaDataReaderControl. This control provides functions for both retrieving and setting meta-data values. Meta-data may be addressed by the keys defined in the QMediaMetaData namespace.

The functionality provided by this control is exposed to application code by the meta-data members of QMediaObject, and so meta-data access is potentially available in any of the media object classes. Any media service may implement QMetaDataReaderControl.

The interface name of QMetaDataReaderControl is org.qt-project.qt.metadatareadercontrol/5.0 as defined in QMetaDataReaderControl_iid.

See also QMediaService::requestControl() and QMediaObject.

Member Function Documentation

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

Construct a QMetaDataReaderControl with parent. This class is meant as a base class for service specific meta data providers so this constructor is protected.

[virtual] QMetaDataReaderControl::~QMetaDataReaderControl()

Destroy the meta-data object.

[pure virtual] QStringList QMetaDataReaderControl::availableMetaData() const

[pure virtual] bool QMetaDataReaderControl::isMetaDataAvailable() const

[pure virtual] QVariant QMetaDataReaderControl::metaData(const QString &key) const

[signal] void QMetaDataReaderControl::metaDataAvailableChanged(bool available)

[signal] void QMetaDataReaderControl::metaDataChanged()

Note: Signal metaDataChanged 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(metaDataReaderControl, QOverload<>::of(&QMetaDataReaderControl::metaDataChanged),
      [=](){ /* ... */ });

[signal] void QMetaDataReaderControl::metaDataChanged(const QString &key, const QVariant &value)

Note: Signal metaDataChanged 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(metaDataReaderControl, QOverload<const QString &, const QVariant &>::of(&QMetaDataReaderControl::metaDataChanged),
      [=](const QString &key, const QVariant &value){ /* ... */ });

Macro Documentation

QMetaDataReaderControl_iid

org.qt-project.qt.metadatareadercontrol/5.0

Defines the interface name of the QMetaDataReaderControl class.