kfilemetadataprovider_p.h

Go to the documentation of this file.

/*****************************************************************************
 * Copyright (C) 2010 by Peter Penz <peter.penz@gmx.at>                      *
 *                                                                           *
 * This library is free software; you can redistribute it and/or             *
 * modify it under the terms of the GNU Library General Public               *
 * License as published by the Free Software Foundation; either              *
 * version 2 of the License, or (at your option) any later version.          *
 *                                                                           *
 * This library is distributed in the hope that it will be useful,           *
 * but WITHOUT ANY WARRANTY; without even the implied warranty of            *
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU         *
 * Library General Public License for more details.                          *
 *                                                                           *
 * You should have received a copy of the GNU Library General Public License *
 * along with this library; see the file COPYING.LIB.  If not, write to      *
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,      *
 * Boston, MA 02110-1301, USA.                                               *
 *****************************************************************************/

#ifndef KFILEMETADATAMODEL_H
#define KFILEMETADATAMODEL_H

#include <kurl.h>

#include <QtCore/QHash>
#include <QtCore/QObject>
#include <QtCore/QString>

#include <config-kio.h>
#ifndef KIO_NO_NEPOMUK
    #define DISABLE_NEPOMUK_LEGACY
    #include <variant.h>
#endif

class KFileItemList;
class KUrl;
class QWidget;

class KFileMetaDataProvider : public QObject
{
    Q_OBJECT

public:
    explicit KFileMetaDataProvider(QObject* parent = 0);
    virtual ~KFileMetaDataProvider();

    void setItems(const KFileItemList& items);
    KFileItemList items() const;

    void setReadOnly(bool readOnly);
    bool isReadOnly() const;

    virtual QString label(const KUrl& metaDataUri) const;

    virtual QString group(const KUrl& metaDataUri) const;

#ifndef KIO_NO_NEPOMUK

    virtual QHash<KUrl, Nepomuk::Variant> data() const;

    virtual QWidget* createValueWidget(const KUrl& metaDataUri,
                                       const Nepomuk::Variant& value,
                                       QWidget* parent) const;
#endif

Q_SIGNALS:
    void loadingFinished();

    void urlActivated(const KUrl& url);

    void dataChangeStarted();
    void dataChangeFinished();

private:
    class Private;
    Private* const d;

    Q_PRIVATE_SLOT(d, void slotLoadingFinished(QThread* finishedThread))
    Q_PRIVATE_SLOT(d, void slotRatingChanged(unsigned int rating))
    Q_PRIVATE_SLOT(d, void slotTagsChanged(const QList<Nepomuk::Tag>& tags))
    Q_PRIVATE_SLOT(d, void slotCommentChanged(const QString& comment))
    Q_PRIVATE_SLOT(d, void slotTagClicked(const Nepomuk::Tag& tag))
    Q_PRIVATE_SLOT(d, void slotLinkActivated(const QString&))

    friend class KLoadMetaDataThread; // invokes KMetaDataObject::loadData()
};

#endif