Plasma/libplasma2/API Review/Service: Difference between revisions

From KDE Community Wiki
No edit summary
No edit summary
Line 1: Line 1:
New class in QML bindings: ServiceOperationStatus {
=New class in QML bindings=
Needed to access wether an operation is enable or not (like in the nowPlaying service
  ServiceOperationStatus {
     property bool enabled
     property bool enabled
     property Service service
     property Service service
     property string operation
     property string operation
}
}


=Class API=
{| cellspacing="0" cellpadding="5" border="1" style="border: 1px solid gray; border-collapse: collapse; text-align: left; width: 100%;" class="sortable"
{| cellspacing="0" cellpadding="5" border="1" style="border: 1px solid gray; border-collapse: collapse; text-align: left; width: 100%;" class="sortable"
|- style="background: rgb(236, 236, 236) none repeat scroll 0% 0%; -moz-background-clip: border; -moz-background-origin: padding; -moz-background-inline-policy: continuous; white-space: nowrap;"
|- style="background: rgb(236, 236, 236) none repeat scroll 0% 0%; -moz-background-clip: border; -moz-background-origin: padding; -moz-background-inline-policy: continuous; white-space: nowrap;"
as
 
! Status  
! Status  
! Action  
! Action  
Line 17: Line 20:
{{FeatureDone|Keep | Q_INVOKABLE QStringList operationNames() const;}}
{{FeatureDone|Keep | Q_INVOKABLE QStringList operationNames() const;}}
{{FeatureTodo|Rename|Q_INVOKABLE KConfigGroup operationDescription(const QString &operationName); -> QVariantMap operationDescription(const QString &operationName); }}
{{FeatureTodo|Rename|Q_INVOKABLE KConfigGroup operationDescription(const QString &operationName); -> QVariantMap operationDescription(const QString &operationName); }}
{{FeatureTodo|Rename|Q_INVOKABLE ServiceJob *startOperationCall(const KConfigGroup->QVariantMap &description, QObject *parent = 0);}}
{{FeatureTodo|Rename|Q_INVOKABLE ServiceJob *startOperationCall(const KConfigGroup->QVariantMap &description, QObject *parent );}}
{{FeatureDone|Keep | Q_INVOKABLE bool isOperationEnabled(const QString &operation) const;}}
{{FeatureDone|Keep | Q_INVOKABLE bool isOperationEnabled(const QString &operation) const;}}
{{FeatureDone|Keep | Q_INVOKABLE QString name() const;}}
{{FeatureDone|Keep | Q_INVOKABLE QString name() const;}}

Revision as of 11:35, 29 April 2013

New class in QML bindings

Needed to access wether an operation is enable or not (like in the nowPlaying service

 ServiceOperationStatus {
   property bool enabled
   property Service service
   property string operation
}

Class API

Status Action Method
TO DO Remove static Service *access(const QUrl &url, QObject *parent); <{{{3}}}>
TO DO Remove Q_INVOKABLE void setDestination(const QString &destination); <{{{3}}}>
TO DO Remove Q_INVOKABLE QString destination() const; <{{{3}}}>
DONE Keep Q_INVOKABLE QStringList operationNames() const;
TO DO Rename Q_INVOKABLE KConfigGroup operationDescription(const QString &operationName); -> QVariantMap operationDescription(const QString &operationName); <{{{3}}}>
TO DO Rename Q_INVOKABLE ServiceJob *startOperationCall(const KConfigGroup->QVariantMap &description, QObject *parent ); <{{{3}}}>
DONE Keep Q_INVOKABLE bool isOperationEnabled(const QString &operation) const;
DONE Keep Q_INVOKABLE QString name() const;
TO DO Remove Q_INVOKABLE void associateItem(QQuickItem->QObject *item, const QString &operation); <{{{3}}}>
TO DO Remove Q_INVOKABLE void disassociateItem(QQuickItem *widget); <{{{3}}}>
TO DO Remove Q_INVOKABLE QHash<QString, QVariant> parametersFromDescription(const KConfigGroup &description); <{{{3}}}>


TO DO Remove SIGNAL void operationsChanged(); <{{{3}}}>
DONE Keep SIGNAL void serviceReady(Plasma::Service *service);
TO DO Add SIGNAL void operationEnabled(const QString &operation, bool enabled); <{{{3}}}>


DONE Keep {{{2}}}
TO DO Remove protected Service(QObject *parent, const QVariantList &args); <{{{3}}}>
TO DO Parameters protected virtual ServiceJob *createJob(const QString &operation, QHash<QString, QVariant> ->QVariantMap &parameters) <{{{3}}}>


DONE Keep protected virtual void registerOperationsScheme();
DONE Keep protected void setOperationsScheme(QIODevice *xml);
DONE Keep protected void setName(const QString &name);
TO DO Multithread protected void setOperationEnabled(const QString &operation, bool enable); -> use a QRunnable here <{{{3}}}>


TO DO Remove private  Q_PRIVATE_SLOT(d, void associatedWidgetDestroyed(QObject *)) <{{{3}}}>
TO DO Remove private  Q_PRIVATE_SLOT(d, void associatedItemDestroyed(QObject *)) <{{{3}}}>