CommandHistory.h

Go to the documentation of this file.

/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */

/*
    Sonic Visualiser
    An audio file viewer and annotation editor.
    Centre for Digital Music, Queen Mary, University of London.
    
    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) any later version.  See the file
    COPYING included with this distribution for more information.
*/

/*
   This is a modified version of a source file from the Rosegarden
   MIDI and audio sequencer and notation editor, copyright 2000-2006
   Chris Cannam, distributed under the GNU General Public License.

   This file contains traces of the KCommandHistory class from the KDE
   project, copyright 2000 Werner Trobin and David Faure and
   distributed under the GNU Lesser General Public License.
*/

#ifndef SV_MULTI_VIEW_COMMAND_HISTORY_H
#define SV_MULTI_VIEW_COMMAND_HISTORY_H

#include <QObject>
#include <QString>

#include <stack>
#include <set>
#include <map>

class Command;
class MacroCommand;
class QAction;
class QMenu;
class QToolBar;
class QTimer;

class CommandHistory : public QObject
{
    Q_OBJECT

public:
    virtual ~CommandHistory();

    static CommandHistory *getInstance();

    void clear();
    
    void registerMenu(QMenu *menu);
    void registerToolbar(QToolBar *toolbar);

    void addCommand(Command *command);
    
    void addCommand(Command *command, bool execute, bool bundle = false);
    
    int getUndoLimit() const { return m_undoLimit; }

    void setUndoLimit(int limit);

    int getRedoLimit() const { return m_redoLimit; }

    void setRedoLimit(int limit);
    
    int getMenuLimit() const { return m_menuLimit; }

    void setMenuLimit(int limit);

    int getBundleTimeout() const { return m_bundleTimeout; }

    void setBundleTimeout(int msec);

    void startCompoundOperation(QString name, bool execute);

    void endCompoundOperation();

public slots:
    virtual void documentSaved();

    void addExecutedCommand(Command *);

    void addCommandAndExecute(Command *);

    void undo();
    void redo();

protected slots:
    void undoActivated(QAction *);
    void redoActivated(QAction *);
    void bundleTimerTimeout();
    
signals:
    void commandExecuted();

    void commandExecuted(Command *);

    void commandUnexecuted(Command *);

    void documentRestored();

    void activity(QString);

protected:
    CommandHistory();
    static CommandHistory *m_instance;

    QAction *m_undoAction;
    QAction *m_redoAction;
    QAction *m_undoMenuAction;
    QAction *m_redoMenuAction;
    QMenu *m_undoMenu;
    QMenu *m_redoMenu;

    std::map<QAction *, int> m_actionCounts;

    typedef std::stack<Command *> CommandStack;
    CommandStack m_undoStack;
    CommandStack m_redoStack;

    int m_undoLimit;
    int m_redoLimit;
    int m_menuLimit;
    int m_savedAt;

    MacroCommand *m_currentCompound;
    bool m_executeCompound;
    void addToCompound(Command *command, bool execute);

    MacroCommand *m_currentBundle;
    bool m_bundling;
    QString m_currentBundleName;
    QTimer *m_bundleTimer;
    int m_bundleTimeout;
    void addToBundle(Command *command, bool execute);
    void closeBundle();
    
    void updateActions();

    void clipCommands();

    void clipStack(CommandStack &stack, int limit);
    void clearStack(CommandStack &stack);
};


#endif