MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

Contents

QMetaDataWriterControl Class Reference

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

 #include <QMetaDataWriterControl>

Inherits: QMediaControl.

This class was introduced in Qt Mobility 1.0.

Public Functions

~QMetaDataWriterControl ()
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 bool isWritable () const = 0
virtual QVariant metaData ( QtMultimediaKit::MetaData key ) const = 0
virtual void setExtendedMetaData ( const QString & key, const QVariant & value ) = 0
virtual void setMetaData ( QtMultimediaKit::MetaData key, const QVariant & value ) = 0
  • 29 public functions inherited from QObject

Signals

void metaDataAvailableChanged ( bool available )
void metaDataChanged ()
void writableChanged ( bool writable )

Protected Functions

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

Macros

QMetaDataWriterControl_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 QMetaDataWriterControl class provides write access to the meta-data of a QMediaService's media.

If a QMediaService can provide write access to the meta-data of its current media it will implement QMetaDataWriterControl. 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 QMetaDataControl.

The interface name of QMetaDataWriterControl is com.nokia.Qt.QMetaDataWriterControl/1.0 as defined in QMetaDataWriterControl_iid.

See also QMediaService::requestControl() and QMediaObject.

Member Function Documentation

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

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

QMetaDataWriterControl::~QMetaDataWriterControl ()

Destroy the meta-data writer control.

QStringList QMetaDataWriterControl::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> QMetaDataWriterControl::availableMetaData () const [pure virtual]

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

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

Returns the meta-data 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.

See also setExtendedMetaData().

bool QMetaDataWriterControl::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.

bool QMetaDataWriterControl::isWritable () const [pure virtual]

Identifies if a media service's meta-data can be edited.

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

This function was introduced in Qt Mobility 1.0.

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

Returns the meta-data for the given key.

This function was introduced in Qt Mobility 1.0.

See also setMetaData().

void QMetaDataWriterControl::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 QMetaDataWriterControl::metaDataChanged () [signal]

Signal the changes of meta-data.

This function was introduced in Qt Mobility 1.0.

void QMetaDataWriterControl::setExtendedMetaData ( const QString & key, const QVariant & value ) [pure virtual]

Change the value of the meta-data element with an abitrary string key to value.

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.

See also extendedMetaData().

void QMetaDataWriterControl::setMetaData ( QtMultimediaKit::MetaData key, const QVariant & value ) [pure virtual]

Sets the value of the meta-data element with the given key.

This function was introduced in Qt Mobility 1.0.

See also metaData().

void QMetaDataWriterControl::writableChanged ( bool writable ) [signal]

Signal a change in the writable status of meta-data, writable will be true if meta-data elements can be added or adjusted.

This function was introduced in Qt Mobility 1.0.

Macro Documentation

QMetaDataWriterControl_iid

com.nokia.Qt.QMetaDataWriterControl/1.0

Defines the interface name of the QMetaDataWriterControl class.

© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.

All other trademarks are property of their respective owners. Privacy Policy


Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.

Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.