MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QMetaDataReaderControl Class Reference

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

 #include <QMetaDataReaderControl>

Inherits: QMediaControl.

This class was introduced in Qt Mobility 1.0.

Public Functions

~QMetaDataReaderControl ()
virtual QStringList availableExtendedMetaData () const = 0
virtual QList<QtMultimediaKit::MetaData> availableMetaData () const = 0
virtual QVariant extendedMetaData ( const QString & key ) const = 0
virtual bool isMetaDataAvailable () const = 0
virtual QVariant metaData ( QtMultimediaKit::MetaData key ) const = 0
  • 29 public functions inherited from QObject

Signals

void metaDataAvailableChanged ( bool available )
void metaDataChanged ()

Protected Functions

QMetaDataReaderControl ( QObject * parent = 0 )
  • 7 protected functions inherited from QObject

Macros

QMetaDataReaderControl_iid

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables 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 well defined keys in the QtMultimediaKit::MetaData enumeration using the metaData() functions, or by string keys using the extendedMetaData() functions.

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 com.nokia.Qt.QMetaDataReaderControl/1.0 as defined in QMetaDataReaderControl_iid.

See also QMediaService::requestControl() and QMediaObject.

Member Function Documentation

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

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

QMetaDataReaderControl::~QMetaDataReaderControl ()

Destroy the meta-data object.

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

Returns a list of keys there is extended meta-data available for.

This function was introduced in Qt Mobility 1.0.

QList<QtMultimediaKit::MetaData> QMetaDataReaderControl::availableMetaData () const [pure virtual]

Returns a list of keys there is meta-data available for.

This function was introduced in Qt Mobility 1.0.

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

Returns the metaData for an abitrary string key.

The valid selection of keys for extended meta-data is determined by the provider and the meaning and type may differ between providers.

This function was introduced in Qt Mobility 1.0.

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

Identifies if meta-data is available from a media service.

Returns true if the meta-data is available and false otherwise.

This function was introduced in Qt Mobility 1.0.

QVariant QMetaDataReaderControl::metaData ( QtMultimediaKit::MetaData key ) const [pure virtual]

Returns the meta-data for the given key.

This function was introduced in Qt Mobility 1.0.

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

Signal the availability of meta-data has changed, available will be true if the multimedia object has meta-data.

This function was introduced in Qt Mobility 1.0.

void QMetaDataReaderControl::metaDataChanged () [signal]

Signal the changes of meta-data.

This function was introduced in Qt Mobility 1.0.

Macro Documentation

QMetaDataReaderControl_iid

com.nokia.Qt.QMetaDataReaderControl/1.0

Defines the interface name of the QMetaDataReaderControl class.