tagactionmanager.h

Go to the documentation of this file.

/* Copyright 2010 Thomas McGuire <mcguire@kde.org>

   Copyright 2011 Laurent Montel <montel@kde.org>

   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
   published by the Free Software Foundation; either version 2 of
   the License or (at your option) version 3 or any later version
   accepted by the membership of KDE e.V. (or its successor approved
   by the membership of KDE e.V.), which shall act as a proxy
   defined in Section 14 of version 3 of the license.

   This program 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 General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef TAGACTIONMANAGER_H
#define TAGACTIONMANAGER_H

#include "kmail_export.h"
#include "tag.h"
#include <QMap>

namespace Nepomuk2
{
class Resource;
namespace Query
{
class QueryServiceClient;
class Result;
}
}

class KActionCollection;
class KXMLGUIClient;
class KToggleAction;
class QAction;
class QSignalMapper;
class KAction;
namespace Akonadi {
class Item;
}

namespace MessageCore {
class AsyncNepomukResourceRetriever;
}

namespace KMail {

class MessageActions;

class KMAIL_EXPORT TagActionManager : public QObject
{
    Q_OBJECT
public:

    TagActionManager( QObject *parent, KActionCollection *actionCollection,
                      MessageActions *messageActions, KXMLGUIClient *guiClient );

    ~TagActionManager();

    void clearActions();

    void createActions();

    void updateActionStates( int numberOfSelectedMessages,
                             const Akonadi::Item &selectedItem );


Q_SIGNALS:

    void tagActionTriggered( const QString &tagLabel );
    void tagMoreActionClicked();

private Q_SLOTS:
    void newTagEntries(const QList<Nepomuk2::Query::Result>& results);
    void finishedTagListing();
    void tagsChanged();
    void resourceCreated(const Nepomuk2::Resource&,const QList<QUrl>&);
    void resourceRemoved(const QUrl&,const QList<QUrl>&);
    void propertyChanged(const Nepomuk2::Resource&);
    void newTagActionClicked();

    void slotLoadedResourceForUpdateActionStates(const QUrl& uri, const Nepomuk2::Resource& res);

private:
    void createTagAction( const MailCommon::Tag::Ptr &tag, bool addToMenu );
    void createTagActions();

    QList<QUrl> checkedTags() const;
    void checkTags( const QList<QUrl> &tags );

    KActionCollection *mActionCollection;
    MessageActions *mMessageActions;
    QSignalMapper *mMessageTagToggleMapper;
    KXMLGUIClient *mGUIClient;

    QAction *mSeparatorMoreAction;
    QAction *mSeparatorNewTagAction;
    KAction *mMoreAction;
    KAction *mNewTagAction;
    // Maps the resource URI or a tag to the action of a tag.
    // Contains all existing tags
    QMap<QString,KToggleAction*> mTagActions;

    // The actions of all tags that are in the toolbar
    QList<QAction*> mToolbarActions;

    // Cache of the tags to avoid expensive Nepomuk queries
    QList<MailCommon::Tag::Ptr> mTags;

    Nepomuk2::Query::QueryServiceClient *mTagQueryClient;
    MessageCore::AsyncNepomukResourceRetriever *mAsyncNepomukRetriver;

    // Uri of a newly created tag
    QString mNewTagUri;
};
}

#endif