undo_redo_container.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2009 [email protected]
 * Copyright (C) 2011 Wayne Stambaugh <[email protected]>
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * 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.
 *
 * 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 <https://www.gnu.org/licenses/>.
 */
 
#ifndef _CLASS_UNDOREDO_CONTAINER_H
#define _CLASS_UNDOREDO_CONTAINER_H
 
#include <core/typeinfo.h>
#include <eda_item_flags.h>
#include <functional>
#include <kiid.h>
#include <vector>
#include <wx/string.h>
 
class EDA_ITEM;
class PICKED_ITEMS_LIST;
class BASE_SCREEN;
 

 

enum class UNDO_REDO {
    UNSPECIFIED = 0,    // illegal
    CHANGED,            // params of items have a value changed: undo is made by exchange
                        // values with a copy of these values
    NEWITEM,            // new item, undo by changing in deleted
    DELETED,            // deleted item, undo by changing in deleted
    LIBEDIT,            // Specific to the component editor (symbol_editor creates a full copy
                        // of the current component when changed)
    LIB_RENAME,         // As LIBEDIT, but old copy should be removed from library
    DRILLORIGIN,        // origin changed (like CHANGED, contains the origin and a copy)
    GRIDORIGIN,         // origin changed (like CHANGED, contains the origin and a copy)
    PAGESETTINGS,       // page settings or title block changes
    REPEAT_ITEM,        // storage entry for the editor's global repeatItems list
    VARIANTS            // one or more variants were added, deleted, or changed
};
 
 
class ITEM_PICKER
{
public:
    ITEM_PICKER();
    ITEM_PICKER( BASE_SCREEN* aScreen, EDA_ITEM* aItem,
                 UNDO_REDO aStatus = UNDO_REDO::UNSPECIFIED );
 
    EDA_ITEM* GetItem() const { return m_pickedItem; }
    void SetItem( EDA_ITEM* aItem );
 
    void SetStatus( UNDO_REDO aStatus ) { m_undoRedoStatus = aStatus; }
    UNDO_REDO GetStatus() const { return m_undoRedoStatus; }
 
    void SetFlags( EDA_ITEM_FLAGS aFlags ) { m_pickerFlags = aFlags; }
    EDA_ITEM_FLAGS GetFlags() const { return m_pickerFlags; }
 
    void SetLink( EDA_ITEM* aItem );
    EDA_ITEM* GetLink() const { return m_link; }
 
    KIID GetGroupId() const { return m_groupId; }
    std::vector<KIID> GetGroupMembers() const { return m_groupMembers; }
 
    BASE_SCREEN* GetScreen() const { return m_screen; }
 
private:
    EDA_ITEM_FLAGS m_pickerFlags;      /* A copy of m_flags member. Currently used only to flag
                                        * transient items. */
    UNDO_REDO      m_undoRedoStatus;   /* type of operation to undo/redo for this item */
    EDA_ITEM*      m_pickedItem;       /* Pointer on the schematic or board item that is concerned
                                        * (picked), or in undo redo commands, the copy of an
                                        * edited item. */
    KICAD_T        m_pickedItemType;   /* type of schematic or board item that is concerned */
 
    EDA_ITEM*      m_link;             /* Pointer on another item. Used in undo redo command
                                        * used when a duplicate exists i.e. when an item is
                                        * modified, and the copy of initial item exists (the
                                        * duplicate) m_Item points the duplicate (i.e the old
                                        * copy of an active item) and m_Link points the active
                                        * item in schematic */
    KIID           m_groupId;          /* Id of the parent group */
    std::vector<KIID> m_groupMembers;  /* Ids of the members of a group */
 
    BASE_SCREEN*   m_screen;           /* For new and deleted items the screen the item should
                                        * be added to/removed from. */
 
};
 

class PICKED_ITEMS_LIST
{
public:
    PICKED_ITEMS_LIST();
    ~PICKED_ITEMS_LIST();

    void PushItem( const ITEM_PICKER& aItem );

    ITEM_PICKER PopItem();

    bool ContainsItem( const EDA_ITEM* aItem ) const;

    int FindItem( const EDA_ITEM* aItem ) const;

    void ClearItemsList();

    void ClearListAndDeleteItems( std::function<void(EDA_ITEM*)> aItemDeleter );

    unsigned GetCount() const
    {
        return m_ItemsList.size();
    }

    void ReversePickersListOrder();

    const ITEM_PICKER& GetItemWrapper( unsigned int aIdx ) const;
    ITEM_PICKER& GetItemWrapper( unsigned int aIdx );

    EDA_ITEM* GetPickedItem( unsigned int aIdx ) const;

    BASE_SCREEN* GetScreenForItem( unsigned int aIdx ) const;

    EDA_ITEM* GetPickedItemLink( unsigned int aIdx ) const;

    UNDO_REDO GetPickedItemStatus( unsigned int aIdx ) const;

    EDA_ITEM_FLAGS GetPickerFlags( unsigned aIdx ) const;

    bool SetPickedItem( EDA_ITEM* aItem, unsigned aIdx );

    bool SetPickedItemLink( EDA_ITEM* aLink, unsigned aIdx );

    bool SetPickedItemStatus( UNDO_REDO aStatus, unsigned aIdx );

    bool SetPickerFlags( EDA_ITEM_FLAGS aFlags, unsigned aIdx );

    bool RemovePicker( unsigned aIdx );

    void CopyList( const PICKED_ITEMS_LIST& aSource );
 
    wxString GetDescription() const                     { return m_description; }
    void SetDescription( const wxString& aDescription ) { m_description = aDescription; }
 
private:
    wxString                 m_description;
    std::vector<ITEM_PICKER> m_ItemsList;
};
 

class UNDO_REDO_CONTAINER
{
public:
    UNDO_REDO_CONTAINER();
    ~UNDO_REDO_CONTAINER();
 
    // We own at least one list of raw pointers.  Don't let the compiler fill in copy c'tors that
    // will only land us in trouble.
    UNDO_REDO_CONTAINER( const UNDO_REDO_CONTAINER& ) = delete;
    UNDO_REDO_CONTAINER& operator=( const UNDO_REDO_CONTAINER& ) = delete;
 
    void PushCommand( PICKED_ITEMS_LIST* aCommand );
 
    PICKED_ITEMS_LIST* PopCommand();
 
    void ClearCommandList();
 
    std::vector <PICKED_ITEMS_LIST*> m_CommandsList;   // the list of possible undo/redo commands
};
 
 
#endif      // _CLASS_UNDOREDO_CONTAINER_H