Home · All Classes · All Functions ·

QMetaDataWriterControl Class Reference

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

    #include <QMetaDataWriterControl>

This class is under development and is subject to change.

Inherits QMediaControl.

Public Functions

Signals

Protected Functions

Macros

Additional Inherited Members


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.

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.

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

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.


Macro Documentation

QMetaDataWriterControl_iid

com.nokia.Qt.QMetaDataWriterControl/1.0

Defines the interface name of the QMetaDataWriterControl class.


Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.1