/*
* This file is part of wxSmith plugin for Code::Blocks Studio
* Copyright (C) 2006-2007  Bartlomiej Swiecki
*
* wxSmith 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 3 of the License, or
* (at your option) any later version.
*
* wxSmith 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 wxSmith. If not, see <http://www.gnu.org/licenses/>.
*
* $Revision: 8251 $
* $Id: wxsitemundobuffer.h 8251 2012-08-28 02:31:00Z ollydbg $
* $HeadURL: http://svn.code.sf.net/p/codeblocks/code/branches/release-xx.yy/src/plugins/contrib/wxSmith/wxwidgets/wxsitemundobuffer.h $
*/

#ifndef WXSITEMUNDOBUFFER_H
#define WXSITEMUNDOBUFFER_H

#include <wx/arrstr.h>

/** \brief This class is used to handle all Undo and Redo actions.
 *
 * This class bases on idea that any class can be represented
 * as Xml structure which can be hold inside simple string.
 * Each undo position entry holds whole structure of resource, what
 * in case of standard resources should not exceed 50 kB. In case
 * of memory consumption problems this can be changed to hold differences
 * between two xml nodes only.
 */
class wxsItemUndoBuffer
{
    public:

        /** \brief Ctor */
        wxsItemUndoBuffer(int MaxEnteries=100);

        /** \brief Dctor */
        ~wxsItemUndoBuffer();

        /** \brief Checking if we can undo */
        inline bool CanUndo() { return m_CurrentPos > 0; }

        /** \brief Checking if we can redo */
        inline bool CanRedo() { return m_CurrentPos < GetCount() - 1; }

        /** \brief Checking if current undo position is modified relatively to form saved on disk */
        inline bool IsModified() { return m_CurrentPos != m_SavedPos; }

        /** \brief Adding new undo position
         *  \param XmlData xml form of resource stored inside string
         */
        void StoreChange(const wxString& XmlData);


        /** \brief Setting lastest undo buffer to saved state (equivalent to content on files) */
        inline void Saved() { m_SavedPos = m_CurrentPos; }

        /** \brief Undoing
         * \return Xml data previously provided in StoreChange or empty string if can not undo
         */
        const wxString& Undo();

        /** \brief Redoing
         * \return Xml data previously provided in StoreChange or empty string if can not undo
         */
        const wxString& Redo();

    private:

        /** \brief Getting number of entries in undo array */
        inline int GetCount() { return (int)m_Enteries.Count(); }

        wxArrayString m_Enteries;   ///< \brief Array entries
        int m_CurrentPos;           ///< \brief Current position in undo buffer
        int m_SavedPos;             ///< \brief Undo position representing not-changed resource (in form it's on disk)
        int m_MaxEnteries;          ///< \brief Max entries in undo buffer
};

#endif
