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 (C) 2021-2023 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
#ifndef INCLUDE_TOOL_SELECTION_TOOL_H_
#define INCLUDE_TOOL_SELECTION_TOOL_H_
 
#include <math/vector2d.h>
#include <tool/tool_interactive.h>
#include <wx/timer.h>
 
class COLLECTOR;
 
 
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 );
 
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; // Items should be added to sel (instead of replacing)
 bool m_subtractive; // Items should be removed from sel
 bool m_exclusive_or; // Items' selection state should be toggled
 bool m_multiple; // Multiple selection mode is active
 bool m_skip_heuristics; // Show disambuguation menu for all items under the
 // cursor rather than trying to narrow them down first
 // using heuristics
 bool m_highlight_modifier;// select highlight net on left click
 bool m_drag_additive; // Add multiple items to selection
 bool m_drag_subtractive; // Remove multiple from selection
 
 bool m_canceledMenu; // Sets to true if the disambiguation menu was cancelled
 
 wxTimer m_disambiguateTimer; // Timer to show the disambiguate menu
 
 VECTOR2I m_originalCursor; // Location of original cursor when starting click
};
 
#endif /* INCLUDE_TOOL_SELECTION_TOOL_H_ */