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