selection_tool.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * 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 3
 * 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, you may find one here:
 * http://www.gnu.org/licenses/gpl-3.0.html
 * or you may search the http://www.gnu.org website for the version 3 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
 */
 
#pragma once
 
#include <wx/timer.h>
 
#include <math/vector2d.h>
#include <tool/tool_interactive.h>
#include <eda_item.h>
 
class COLLECTOR;
class KIID;
 
 
enum class SELECTION_MODE
{
    INSIDE_RECTANGLE,
    TOUCHING_RECTANGLE,
    INSIDE_LASSO,
    TOUCHING_LASSO
};
 
 
class SELECTION_TOOL : public TOOL_INTERACTIVE, public wxEvtHandler
{
public:
    SELECTION_TOOL( const std::string& aName );
    ~SELECTION_TOOL(){};

    int UpdateMenu( const TOOL_EVENT& aEvent );
 
    int AddItemToSel( const TOOL_EVENT& aEvent );
    void AddItemToSel( EDA_ITEM* aItem, bool aQuietMode = false );
    int AddItemsToSel( const TOOL_EVENT& aEvent );
    void AddItemsToSel( EDA_ITEMS* aList, bool aQuietMode = false );
 
    int RemoveItemFromSel( const TOOL_EVENT& aEvent );
    void RemoveItemFromSel( EDA_ITEM* aItem, bool aQuietMode = false );
    int RemoveItemsFromSel( const TOOL_EVENT& aEvent );
    void RemoveItemsFromSel( EDA_ITEMS* aList, bool aQuietMode = false );
 
    int ReselectItem( const TOOL_EVENT& aEvent );

    void RemoveItemsFromSel( std::vector<KIID>* aList, bool aQuietMode = false );
 
    void BrightenItem( EDA_ITEM* aItem );
    void UnbrightenItem( EDA_ITEM* aItem );

    int SelectionMenu( const TOOL_EVENT& aEvent );
 
    SELECTION& GetSelection() { return selection(); }
 
    virtual void EnterGroup() {}
    virtual void ExitGroup( bool aSelectGroup = false ) {}
 
protected:
    virtual SELECTION& selection() = 0;

   void onDisambiguationExpire( wxTimerEvent& aEvent );

    virtual void select( EDA_ITEM* aItem ) = 0;

    virtual void unselect( EDA_ITEM* aItem ) = 0;

    virtual void highlight( EDA_ITEM* aItem, int aHighlightMode, SELECTION* aGroup = nullptr ) = 0;

    virtual void unhighlight( EDA_ITEM* aItem, int aHighlightMode,
                              SELECTION* aGroup = nullptr ) = 0;

    void setModifiersState( bool aShiftState, bool aCtrlState, bool aAltState );

    bool hasModifier();

    virtual bool ctrlClickHighlights() { return false; }
 
    bool doSelectionMenu( COLLECTOR* aCollector );
 
protected:
    bool            m_additive;          
    bool            m_subtractive;       
    bool            m_exclusive_or;      
    bool            m_multiple;          

    bool            m_skip_heuristics;
    bool            m_highlight_modifier;
    bool            m_drag_additive;     
    bool            m_drag_subtractive;  
 
    bool            m_canceledMenu;      
 
    wxTimer         m_disambiguateTimer; 
 
    VECTOR2I        m_originalCursor;    
};