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.
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.
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.
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.
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.
Returns the meta-data for the given key.
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.
void QMetaDataWriterControl::metaDataChanged () [signal]
Signal the changes of meta-data.
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.
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.
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.
