CopperSpice API  1.9.1
QMetaDataWriterControl Class Referenceabstract

Controls write access to the meta data of a QMediaService's media. More...

Inheritance diagram for QMetaDataWriterControl:
QMediaControl QObject

Public Signals

void metaDataAvailableChanged (bool available)
 
void metaDataChanged ()
 
void metaDataChanged (const QString &key, const QVariant &value)
 
void writableChanged (bool writable)
 
- Public Signals inherited from QObject
void destroyed (QObject *obj=nullptr)
 
void objectNameChanged (const QString &objectName)
 

Public Methods

 ~QMetaDataWriterControl ()
 
virtual QStringList availableMetaData () const = 0
 
virtual bool isMetaDataAvailable () const = 0
 
virtual bool isWritable () const = 0
 
virtual QVariant metaData (const QString &key) const = 0
 
virtual void setMetaData (const QString &key, const QVariant &value) = 0
 
- Public Methods inherited from QMediaControl
 ~QMediaControl ()
 
- Public Methods inherited from QObject
 QObject (QObject *parent=nullptr)
 
 ~QObject ()
 
bool blockSignals (bool block)
 
const QList< QObject * > & children () const
 
bool connect (const QObject *sender, const QString &signalMethod, const QString &location, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
bool connect (const QObject *sender, const QString &signalMethod, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
bool disconnect (const QObject *receiver, const QString &slotMethod=QString ()) const
 
bool disconnect (const QString &signalMethod, const QString &location, const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const
 
bool disconnect (const QString &signalMethod=QString (), const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const
 
void dumpObjectInfo ()
 
void dumpObjectTree ()
 
QList< QStringdynamicPropertyNames () const
 
virtual bool event (QEvent *event)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
template<typename T >
findChild (const QString &childName=QString ()) const
 
template<class T >
QList< T > findChildren (const QRegularExpression &regExp, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 
template<class T >
QList< T > findChildren (const QString &childName=QString (), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 
bool inherits (const QString &className) const
 
void installEventFilter (QObject *filterObj)
 
bool isWidgetType () const
 
bool isWindowType () const
 
void killTimer (int id)
 
const QMetaObjectmetaObject () const
 
void moveToThread (QThread *targetThread)
 
QString objectName () const
 
QObject * parent () const
 
template<class T = QVariant>
property (const QString &name) const
 
void removeEventFilter (QObject *obj)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const QString &name, const QVariant &value)
 
bool signalsBlocked () const
 
int startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
 
QThreadthread () const
 

Protected Methods

 QMetaDataWriterControl (QObject *parent=nullptr)
 
- Protected Methods inherited from QMediaControl
 QMediaControl (QObject *parent=nullptr)
 
- Protected Methods inherited from QObject
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const QMetaMethod &signalMethod) const
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const QMetaMethod &signalMethod) const
 
bool isSignalConnected (const QMetaMethod &signalMethod) const
 
int receivers (const QString &signal) const
 
QObject * sender () const
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *event)
 

Related Functions

These are not member functions

#define QMetaDataWriterControl_iid   "com.copperspice.CS.metaDataWriterControl/1.0"
 

Additional Inherited Members

- Public Slots inherited from QObject
void deleteLater ()
 
- Static Public Methods inherited from QObject
static bool connect (const QObject *sender, const QMetaMethod &signalMethod, const QObject *receiver, const QMetaMethod &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool connect (const QObject *sender, const QString &signalMethod, const QObject *receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection, const QString &location=QString ())
 
static bool connect (const QObject *sender, const QString &signalMethod, const QString &location, const QObject *receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool connect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, SlotReturn (SlotClass::*slotMethod)(SlotArgs...), Qt::ConnectionType type=Qt::AutoConnection)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool connect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, T slotLambda, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const QMetaMethod &signalMethod, const QObject *receiver, const QMetaMethod &slotMethod)
 
static bool disconnect (const QObject *sender, const QString &signalMethod, const QObject *receiver, const QString &slotMethod)
 
static bool disconnect (const QObject *sender, const QString &signalMethod, const QString &location, const QObject *receiver, const QString &slotMethod)
 
static bool disconnect (const QObject *sender, std::nullptr_t, const QObject *receiver, std::nullptr_t)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, SlotReturn (SlotClass::*slotMethod)(SlotArgs...))
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver >
static bool disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, std::nullptr_t slotMethod=nullptr)
 
template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool disconnect (const Sender *sender, void (SignalClass::*signalMethod)(SignalArgs...), const Receiver *receiver, T slotMethod)
 
static QMetaObjectstaticMetaObject ()
 
static QString tr (const char *text, const char *comment=nullptr, std::optional< int > numArg=std::optional< int >())
 
- Properties inherited from QObject
 objectName
 

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 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 metadata access is potentially available in any of the media object classes. Any media service may implement QMetaDataControl.

The interface name of QMetaDataWriterControl is "com.copperspice.CS.metaDataWriterControl/1.0" as defined in QMetaDataWriterControl_iid.

See also
QMediaService::requestControl(), QMediaObject

Constructor & Destructor Documentation

QMetaDataWriterControl::~QMetaDataWriterControl ( )

Destroy the meta data writer control.

QMetaDataWriterControl::QMetaDataWriterControl ( QObject parent = nullptr)
explicitprotected

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

Method Documentation

QStringList QMetaDataWriterControl::availableMetaData ( ) const
pure virtual

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

bool QMetaDataWriterControl::isMetaDataAvailable ( ) const
pure virtual

Identifies if metadata 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 ( const QString key) const
pure virtual

Returns the meta data for the given key.

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

Signals the changes of meta data. If multiple meta data elements are changed the metaDataChanged(const QString &key, const QVariant &value) signal is emitted for each of them with metaDataChanged() changed emitted once.

void QMetaDataWriterControl::metaDataChanged ( const QString key,
const QVariant value 
)
signal

Signal the changes of one meta data element value with the given key.

void QMetaDataWriterControl::setMetaData ( const QString key,
const QVariant value 
)
pure virtual

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

void QMetaDataWriterControl::writableChanged ( bool  writable)
signal

Indicates a change in the writable status of meta data. The value for writable will be true if meta data elements can be added or adjusted.

Friends And Related Function Documentation

#define QMetaDataWriterControl_iid   "com.copperspice.CS.metaDataWriterControl/1.0"
related

Defines the interface name of the QMetaDataWriterControl class to "com.copperspice.CS.metaDataWriterControl/1.0".