agentactionmanager.h

/*
  Copyright (c) 2010 Tobias Koenig <tokoe@kde.org>

  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 AKONADI_AGENTACTIONMANAGER_H
#define AKONADI_AGENTACTIONMANAGER_H

#include "akonadi_export.h"

#include <akonadi/agentinstance.h>

#include <QtCore/QObject>

class KAction;
class KActionCollection;
class KLocalizedString;
class QItemSelectionModel;
class QWidget;

namespace Akonadi {

class AKONADI_EXPORT AgentActionManager : public QObject
{
    Q_OBJECT
public:
    enum Type {
        CreateAgentInstance,       
        DeleteAgentInstance,       
        ConfigureAgentInstance,    
        LastType                   
    };

    enum TextContext {
        DialogTitle,                
        DialogText,                 
        MessageBoxTitle,            
        MessageBoxText,             
        MessageBoxAlternativeText,  
        ErrorMessageTitle,          
        ErrorMessageText            
    };

    explicit AgentActionManager(KActionCollection *actionCollection, QWidget *parent = 0);

    ~AgentActionManager();

    void setSelectionModel(QItemSelectionModel *model);

    void setMimeTypeFilter(const QStringList &mimeTypes);

    void setCapabilityFilter(const QStringList &capabilities);

    KAction *createAction(Type type);

    void createAllActions();

    KAction *action(Type type) const;

    void interceptAction(Type type, bool intercept = true);

    Akonadi::AgentInstance::List selectedAgentInstances() const;

    void setContextText(Type type, TextContext context, const QString &text);

    void setContextText(Type type, TextContext context, const KLocalizedString &text);

Q_SIGNALS:
    void actionStateUpdated();

private:
    //@cond PRIVATE
    class Private;
    Private *const d;

    Q_PRIVATE_SLOT(d, void updateActions())

    Q_PRIVATE_SLOT(d, void slotCreateAgentInstance())
    Q_PRIVATE_SLOT(d, void slotDeleteAgentInstance())
    Q_PRIVATE_SLOT(d, void slotConfigureAgentInstance())

    Q_PRIVATE_SLOT(d, void slotAgentInstanceCreationResult(KJob *))
    //@endcond
};

}

#endif