The selection tool: currently supports: More...

#include <pcb_selection_tool.h>

Inheritance diagram for PCB_SELECTION_TOOL:

Classes
class	PRIV
	Private implementation of firewalled private data. More...

Public Types
enum	RESET_REASON { RUN , MODEL_RELOAD , SUPERMODEL_RELOAD , GAL_SWITCH , REDRAW , SHUTDOWN }
	Determine the reason of reset for a tool. More...

Public Member Functions
	PCB_SELECTION_TOOL ()

	~PCB_SELECTION_TOOL ()

bool	Init () override
	Init() is called once upon a registration of the tool.

void	Reset (RESET_REASON aReason) override
	Bring the tool to a known, initial state.

void	OnIdle (wxIdleEvent &aEvent)

bool	IsFootprintEditor ()

int	Main (const TOOL_EVENT &aEvent)
	The main loop.

PCB_SELECTION &	GetSelection ()

PCB_SELECTION &	RequestSelection (CLIENT_SELECTION_FILTER aClientFilter)
	Return the current selection, filtered according to aClientFilter.

int	CursorSelection (const TOOL_EVENT &aEvent)

int	SelectColumns (const TOOL_EVENT &aEvent)

int	SelectRows (const TOOL_EVENT &aEvent)

int	SelectTable (const TOOL_EVENT &aEvent)
	Clear current selection event handler.

int	ClearSelection (const TOOL_EVENT &aEvent)

void	ClearSelection (bool aQuietMode=false)
	Select all items on the board.

int	SelectAll (const TOOL_EVENT &aEvent)
	Unselect all items on the board.

int	UnselectAll (const TOOL_EVENT &aEvent)
	Change the selection mode.

int	SetSelectRect (const TOOL_EVENT &aEvent)

int	SetSelectPoly (const TOOL_EVENT &aEvent)

int	SelectRectArea (const TOOL_EVENT &aEvent)
	Handles drawing a selection box that allows multiple items to be selected simultaneously.

int	SelectPolyArea (const TOOL_EVENT &aEvent)
	Handles drawing a lasso selection area that allows multiple items to be selected simultaneously.

void	SelectMultiple (KIGFX::PREVIEW::SELECTION_AREA &aArea, bool aSubtractive=false, bool aExclusiveOr=false)
	Selects multiple PCB items within a specified area.

void	FindItem (BOARD_ITEM *aItem)
	Take necessary actions to mark an item as found.

void	select (EDA_ITEM *aItem) override
	Take necessary action mark an item as selected.

bool	Selectable (const BOARD_ITEM *aItem, bool checkVisibilityOnly=false) const

void	SelectAllItemsOnNet (int aNetCode, bool aSelect=true)
	Select all items with the given net code.

void	GuessSelectionCandidates (GENERAL_COLLECTOR &aCollector, const VECTOR2I &aWhere) const
	Try to guess best selection candidates in case multiple items are clicked, by doing some brain-dead heuristics.

void	RebuildSelection ()
	Rebuild the selection from the EDA_ITEMs' selection flags.

PCB_SELECTION_FILTER_OPTIONS &	GetFilter ()
	Set up handlers for various events.

void	setTransitions () override
	Zoom the screen to center and fit the current selection.

void	zoomFitSelection ()
	Zoom the screen to fit the bounding box for cross probing/selection sync.

void	ZoomFitCrossProbeBBox (const BOX2I &bbox)

void	EnterGroup () override
	Enter the group at the head of the current selection.

void	ExitGroup (bool aSelectGroup=false) override
	Leave the currently-entered group.

PCB_GROUP *	GetEnteredGroup ()

PCB_LAYER_ID	GetActiveLayer ()

void	FilterCollectorForLockedItems (GENERAL_COLLECTOR &aCollector)
	In the PCB editor strip out any locked items unless the OverrideLocks checkbox is set.

void	ReportFilteredLockedItems ()
	If the most recent FilterCollectorForLockedItems call removed at least one item, show an InfoBar warning prompting the user to enable Override Locks.

void	FilterCollectorForHierarchy (GENERAL_COLLECTOR &aCollector, bool aMultiselect) const
	In general we don't want to select both a parent and any of it's children.

void	FilterCollectorForFreePads (GENERAL_COLLECTOR &aCollector, bool aForcePromotion=false) const
	Check the "allow free pads" setting and if disabled, replace any pads in the collector with their parent footprints.

void	FilterCollectorForTableCells (GENERAL_COLLECTOR &aCollector) const
	Promote any table cell selections to the whole table.

void	FilterCollectorForMarkers (GENERAL_COLLECTOR &aCollector) const
	Drop any PCB_MARKERs from the collector.

void	FilterCollectedItems (GENERAL_COLLECTOR &aCollector, bool aMultiSelect, PCB_SELECTION_FILTER_OPTIONS *aRejected=nullptr)
	Apply the SELECTION_FITLER_OPTIONS to the collector.

void	FilterCollectorForFootprints (GENERAL_COLLECTOR &aCollector, const VECTOR2I &aWhere) const
	Drop footprints that are not directly selected.

int	UpdateMenu (const TOOL_EVENT &aEvent)
	Update a menu's state based on the current selection.

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)

void	RemoveItemsFromSel (std::vector< KIID > *aList, bool aQuietMode=false)
	A safer version of RemoveItemsFromSel( EDA_ITEMS ) which doesn't require the items to still exist.

int	ReselectItem (const TOOL_EVENT &aEvent)

void	BrightenItem (EDA_ITEM *aItem)

void	UnbrightenItem (EDA_ITEM *aItem)

int	SelectionMenu (const TOOL_EVENT &aEvent)
	Show a popup menu to trim the COLLECTOR passed as aEvent's parameter down to a single item.

void	Activate ()
	Run the tool.

TOOL_MENU &	GetToolMenu ()

void	SetContextMenu (ACTION_MENU *aMenu, CONTEXT_MENU_TRIGGER aTrigger=CMENU_BUTTON)
	Assign a context menu and tells when it should be activated.

void	RunMainStack (std::function< void()> aFunc)
	Call a function using the main stack.

template<class T>
void	Go (int(T::*aStateFunc)(const TOOL_EVENT &), const TOOL_EVENT_LIST &aConditions=TOOL_EVENT(TC_ANY, TA_ANY))
	Define which state (aStateFunc) to go when a certain event arrives (aConditions).

TOOL_EVENT *	Wait (const TOOL_EVENT_LIST &aEventList=TOOL_EVENT(TC_ANY, TA_ANY))
	Suspend execution of the tool until an event specified in aEventList arrives.

TOOL_TYPE	GetType () const
	Return the type of the tool.

TOOL_ID	GetId () const
	Return the unique identifier of the tool.

const std::string &	GetName () const
	Return the name of the tool.

TOOL_MANAGER *	GetManager () const
	Return the instance of TOOL_MANAGER that takes care of the tool.

bool	IsToolActive () const

Protected Member Functions
KIGFX::PCB_VIEW *	view () const

KIGFX::VIEW_CONTROLS *	controls () const

PCB_BASE_FRAME *	frame () const

PCB_BASE_EDIT_FRAME *	editFrame () const

BOARD *	board () const

PCB_DRAW_PANEL_GAL *	canvas () const

virtual bool	ctrlClickHighlights () override
	Determine if ctrl-click is highlight net or XOR selection.

SELECTION &	selection () override
	Return a reference to the selection.

void	onDisambiguationExpire (wxTimerEvent &aEvent)
	Start the process to show our disambiguation menu once the user has kept the mouse down for the minimum time.

void	setModifiersState (bool aShiftState, bool aCtrlState, bool aAltState)
	Set the configuration of m_additive, m_subtractive, m_exclusive_or, m_skip_heuristics from the state of modifier keys SHIFT, CTRL, ALT and depending on the OS.

bool	hasModifier ()
	True if a selection modifier is enabled, false otherwise.

bool	doSelectionMenu (COLLECTOR *aCollector)

void	attachManager (TOOL_MANAGER *aManager)
	Set the TOOL_MANAGER the tool will belong to.

KIGFX::VIEW *	getView () const
	Returns the instance of #VIEW object used in the application.

KIGFX::VIEW_CONTROLS *	getViewControls () const
	Return the instance of VIEW_CONTROLS object used in the application.

template<typename T>
T *	getEditFrame () const
	Return the application window object, casted to requested user type.

template<typename T>
T *	getModel () const
	Return the model object if it matches the requested type.

Protected Attributes
bool	m_additive
	Items should be added to sel (instead of replacing).

bool	m_subtractive
	Items should be removed from selection.

bool	m_exclusive_or
	Items' selection state should be toggled.

bool	m_multiple
	Multiple selection mode is active.

bool	m_skip_heuristics
	Show disambiguation 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 canceled.

wxTimer	m_disambiguateTimer
	Timer to show the disambiguate menu.

VECTOR2I	m_originalCursor
	Location of original cursor when starting click.

std::unique_ptr< TOOL_MENU >	m_menu
	The functions below are not yet implemented - their interface may change.

TOOL_TYPE	m_type

TOOL_ID	m_toolId
	Unique id, assigned by a TOOL_MANAGER instance.

std::string	m_toolName
	Names are expected to obey the format application.ToolName (eg.

TOOL_MANAGER *	m_toolMgr

Private Types
enum	STOP_CONDITION { STOP_AT_JUNCTION , STOP_AT_SEGMENT , STOP_AT_PAD , STOP_NEVER }

Private Member Functions
bool	selectPoint (const VECTOR2I &aWhere, bool aOnDrag=false, bool *aSelectionCancelledFlag=nullptr, CLIENT_SELECTION_FILTER aClientFilter=nullptr)
	Select an item pointed by the parameter aWhere.

bool	selectCursor (bool aForceSelect=false, CLIENT_SELECTION_FILTER aClientFilter=nullptr)
	Select an item under the cursor unless there is something already selected.

bool	selectTableCells (PCB_TABLE *aTable)

void	initializeTableCellSelectionState (PCB_TABLE *aTable)
	Mark the existing selection state of table cells so that drag- and shift-click range selection can preserve previously-selected cells.

void	selectCellsBetween (const VECTOR2D &aStart, const VECTOR2D &aEnd, PCB_TABLE *aTable)
	Select table cells contained within the rectangle defined by two corner points, combining the result with the prior selection state (recorded by initializeTableCellSelectionState) according to the current modifier keys.

bool	extendTableCellSelectionTo (const VECTOR2I &aPosition)
	If the current selection holds one or more cells from a single PCB_TABLE and the cursor is over another cell in that same table, extend the selection to cover the rectangular range between the original anchor cell and the cell under `aPosition`.

bool	toggleTableCellSelection (const VECTOR2I &aPosition)
	When the user Ctrl-clicks inside a PCB_TABLE whose cells are already in the selection, toggle that cell into or out of the selection instead of triggering the net-highlight action.

void	collectTableCellsAt (const VECTOR2I &aPosition, GENERAL_COLLECTOR &aCollector)
	Collect PCB_TABLECELL items at `aPosition` into `aCollector`, scoped to either the active footprint (in the footprint editor) or the full board.

PCB_TABLECELL *	singleSelectedCell () const

int	disambiguateCursor (const TOOL_EVENT &aEvent)
	Handle disambiguation actions including displaying the menu.

int	expandConnection (const TOOL_EVENT &aEvent)
	Expand the current connected-item selection to the next boundary (junctions, pads, or all)

int	unrouteSelected (const TOOL_EVENT &aEvent)
	Unroute the selected board connected items.

int	unrouteSegment (const TOOL_EVENT &aEvent)
	Unroute the selected track connected item.

int	selectNet (const TOOL_EVENT &aEvent)
	Select all copper connections belonging to the same net(s) as the items in the selection.

int	selectNetChain (const TOOL_EVENT &aEvent)
	Select all copper connections belonging to every net in the selected item's net chain.

int	selectUnconnected (const TOOL_EVENT &aEvent)
	Select nearest unconnected footprints on same net as selected items.

int	grabUnconnected (const TOOL_EVENT &aEvent)
	Select and move other nearest footprint unconnected on same net as selected items.

void	selectAllConnectedTracks (const std::vector< BOARD_CONNECTED_ITEM * > &aStartItems, STOP_CONDITION aStopCondition)
	Select connected tracks and vias.

void	selectAllConnectedShapes (const std::vector< PCB_SHAPE * > &aStartItems)
	Select all non-closed shapes that are graphically connected to the given start items.

bool	isExpandableGraphicShape (const EDA_ITEM *aItem) const

void	selectConnections (const std::vector< BOARD_ITEM * > &aItems)

void	selectAllItemsOnSheet (wxString &aSheetPath)
	Select all items with the given sheet timestamp/UUID name (the sheet path).

int	selectSheetContents (const TOOL_EVENT &aEvent)
	Select all footprints belonging to same hierarchical sheet as the selected footprint (same sheet path).

int	selectSameSheet (const TOOL_EVENT &aEvent)
	Set selection to items passed by parameter and connected nets (optionally).

int	syncSelection (const TOOL_EVENT &aEvent)

int	syncSelectionWithNets (const TOOL_EVENT &aEvent)

void	doSyncSelection (const std::vector< BOARD_ITEM * > &aItems, bool aWithNets)
	Invoke filter dialog and modify current selection.

int	filterSelection (const TOOL_EVENT &aEvent)
	Return true if the given item passes the current SELECTION_FILTER_OPTIONS.

bool	itemPassesFilter (BOARD_ITEM aItem, bool aMultiSelect, PCB_SELECTION_FILTER_OPTIONS aRejected=nullptr)

void	unselect (EDA_ITEM *aItem) override
	Take necessary action mark an item as unselected.

void	highlight (EDA_ITEM aItem, int aHighlightMode, SELECTION aGroup=nullptr) override
	Highlight the item visually.

void	unhighlight (EDA_ITEM aItem, int aHighlightMode, SELECTION aGroup=nullptr) override
	Unhighlight the item visually.

bool	selectionContains (const VECTOR2I &aPoint) const

int	hitTestDistance (const VECTOR2I &aWhere, BOARD_ITEM *aItem, int aMaxDistance) const

int	updateSelection (const TOOL_EVENT &aEvent)
	Event handler to update the selection VIEW_ITEM.

void	pruneObscuredSelectionCandidates (GENERAL_COLLECTOR &aCollector) const

const GENERAL_COLLECTORS_GUIDE	getCollectorsGuide () const

void	highlightInternal (EDA_ITEM *aItem, int aHighlightMode, bool aUsingOverlay)

void	unhighlightInternal (EDA_ITEM *aItem, int aHighlightMode, bool aUsingOverlay)

void	resetTransitions ()
	Clear the current transition map and restores the default one created by setTransitions().

void	goInternal (TOOL_STATE_FUNC &aState, const TOOL_EVENT_LIST &aConditions)

EDA_ITEM *	getModelInternal () const

TOOLS_HOLDER *	getToolHolderInternal () const

Private Attributes
PCB_BASE_FRAME *	m_frame

bool	m_isFootprintEditor

PCB_SELECTION	m_selection

PCB_SELECTION_FILTER_OPTIONS	m_filter

KICURSOR	m_nonModifiedCursor

PCB_GROUP *	m_enteredGroup

KIGFX::VIEW_GROUP	m_enteredGroupOverlay

SELECTION_MODE	m_selectionMode

bool	m_lockedItemsFiltered

PCB_TABLECELL *	m_previousFirstCell

std::unique_ptr< PRIV >	m_priv

Detailed Description

The selection tool: currently supports:

pick single objects (click LMB)
add objects to existing selection (Shift+LMB)
draw selection box (drag LMB)
handles FOOTPRINTs properly (i.e. selects either FOOTPRINT or its PADs, TEXTs, etc.)
takes into account high-contrast & layer visibility settings
invokes InteractiveEdit tool when user starts to drag selected items

Definition at line 62 of file pcb_selection_tool.h.

Member Enumeration Documentation

◆ RESET_REASON

enum TOOL_BASE::RESET_REASON

inherited

Determine the reason of reset for a tool.

Enumerator
RUN	Tool is invoked after being inactive.
MODEL_RELOAD	Model changes (the sheet for a schematic)
SUPERMODEL_RELOAD	For schematics, the entire schematic changed, not just the sheet.
GAL_SWITCH	Rendering engine changes.
REDRAW	Full drawing refresh.
SHUTDOWN	Tool is being shut down.

Definition at line 73 of file tool_base.h.

◆ STOP_CONDITION

enum PCB_SELECTION_TOOL::STOP_CONDITION

private

Enumerator
STOP_AT_JUNCTION	Stop at any place where more than two traces meet. Because vias are also traces, this makes selection stop at a via if there is a trace on another layer as well, but a via with only one connection will be selected.
STOP_AT_SEGMENT	Stop when reaching a segment (next track/arc/via).
STOP_AT_PAD	Stop when reaching a pad.
STOP_NEVER	Select the entire net.

Definition at line 419 of file pcb_selection_tool.h.

Constructor & Destructor Documentation

◆ PCB_SELECTION_TOOL()

PCB_SELECTION_TOOL::PCB_SELECTION_TOOL ( )

Definition at line 222 of file pcb_selection_tool.cpp.

References ARROW, INSIDE_RECTANGLE, m_enteredGroup, m_filter, m_frame, m_isFootprintEditor, m_lockedItemsFiltered, m_nonModifiedCursor, m_previousFirstCell, m_priv, m_selectionMode, and SELECTION_TOOL::SELECTION_TOOL().

Referenced by Main().

◆ ~PCB_SELECTION_TOOL()

PCB_SELECTION_TOOL::~PCB_SELECTION_TOOL ( )

Definition at line 248 of file pcb_selection_tool.cpp.

References TOOL_BASE::getView(), m_enteredGroupOverlay, m_selection, SELECTION_TOOL::onDisambiguationExpire(), and KIGFX::VIEW::Remove().

Member Function Documentation

◆ Activate()

void TOOL_INTERACTIVE::Activate ( )

inherited

Run the tool.

After activation, the tool starts receiving events until it is finished.

Definition at line 61 of file tool_interactive.cpp.

References TOOL_BASE::m_toolId, and TOOL_BASE::m_toolMgr.

◆ AddItemsToSel() [1/2]

int SELECTION_TOOL::AddItemsToSel ( const TOOL_EVENT & aEvent )

inherited

Definition at line 137 of file selection_tool.cpp.

References AddItemsToSel(), TOOL_EVENT::Parameter(), selection(), and SELECTION::SetIsHover().

Referenced by AddItemsToSel(), API_HANDLER_BOARD::handleAddToSelection(), SCH_DRAWING_TOOLS::ImportSheet(), SCH_SELECTION_TOOL::Main(), DIALOG_EXCHANGE_FOOTPRINTS::OnOKClicked(), PCB_SELECTION_TOOL::setTransitions(), PL_SELECTION_TOOL::setTransitions(), and SCH_SELECTION_TOOL::setTransitions().

◆ AddItemsToSel() [2/2]

void SELECTION_TOOL::AddItemsToSel	(	EDA_ITEMS *	aList,
		bool	aQuietMode = false )

inherited

Definition at line 145 of file selection_tool.cpp.

References TOOL_BASE::m_toolMgr, select(), and EVENTS::SelectedEvent.

◆ AddItemToSel() [1/2]

int SELECTION_TOOL::AddItemToSel ( const TOOL_EVENT & aEvent )

inherited

◆ AddItemToSel() [2/2]

void SELECTION_TOOL::AddItemToSel	(	EDA_ITEM *	aItem,
		bool	aQuietMode = false )

inherited

Definition at line 112 of file selection_tool.cpp.

References TOOL_BASE::m_toolMgr, select(), and EVENTS::SelectedEvent.

◆ attachManager()

void TOOL_BASE::attachManager ( TOOL_MANAGER * aManager )

protectedinherited

Set the TOOL_MANAGER the tool will belong to.

Called by TOOL_MANAGER::RegisterTool()

Definition at line 58 of file tool_base.cpp.

References m_toolMgr, and TOOL_MANAGER.

Referenced by TOOL_MANAGER::RegisterTool().

◆ board()

BOARD * PCB_SELECTION_TOOL::board ( ) const

inlineprotected

Definition at line 287 of file pcb_selection_tool.h.

References TOOL_BASE::getModel().

Referenced by collectTableCellsAt(), FilterCollectorForFootprints(), filterSelection(), getCollectorsGuide(), grabUnconnected(), RebuildSelection(), Selectable(), selectAllConnectedShapes(), selectAllConnectedTracks(), SelectAllItemsOnNet(), selectAllItemsOnSheet(), selectConnections(), SelectMultiple(), selectNetChain(), selectPoint(), selectUnconnected(), and unrouteSelected().

◆ BrightenItem()

void SELECTION_TOOL::BrightenItem ( EDA_ITEM * aItem )

inherited

Definition at line 216 of file selection_tool.cpp.

References BRIGHTENED, and highlight().

Referenced by SCH_EDIT_FRAME::DisplayCurrentSheet(), BOARD_INSPECTION_TOOL::InspectClearance(), PCB_CONTROL::InteractiveDelete(), PL_EDIT_TOOL::InteractiveDelete(), SCH_TOOL_BASE< T >::InteractiveDelete(), PANEL_COMPONENT_CLASS_ASSIGNMENT::OnHighlightItemsClick(), BOARD_INSPECTION_TOOL::pickItemForInspection(), SCH_EDITOR_CONTROL::SimProbe(), and SCH_EDITOR_CONTROL::SimTune().

◆ canvas()

PCB_DRAW_PANEL_GAL * PCB_SELECTION_TOOL::canvas ( ) const

inlineprotected

Definition at line 292 of file pcb_selection_tool.h.

References frame(), and PCB_BASE_FRAME::GetCanvas().

Referenced by FindItem().

◆ ClearSelection() [1/2]

void PCB_SELECTION_TOOL::ClearSelection ( bool aQuietMode = false )

Select all items on the board.

Definition at line 3719 of file pcb_selection_tool.cpp.

References EVENTS::ClearedEvent, PCB_ACTIONS::hideLocalRatsnest, m_previousFirstCell, m_selection, TOOL_BASE::m_toolMgr, SELECTED, unhighlight(), KIGFX::PCB_VIEW::Update(), and view().

◆ ClearSelection() [2/2]

int PCB_SELECTION_TOOL::ClearSelection ( const TOOL_EVENT & aEvent )

◆ collectTableCellsAt()

void PCB_SELECTION_TOOL::collectTableCellsAt	(	const VECTOR2I &	aPosition,
		GENERAL_COLLECTOR &	aCollector )

private

Collect PCB_TABLECELL items at aPosition into aCollector, scoped to either the active footprint (in the footprint editor) or the full board.

Definition at line 1213 of file pcb_selection_tool.cpp.

References board(), GENERAL_COLLECTOR::Collect(), getCollectorsGuide(), BOARD::GetFirstFootprint(), m_isFootprintEditor, and PCB_TABLECELL_T.

Referenced by extendTableCellSelectionTo(), Main(), and toggleTableCellSelection().

◆ controls()

KIGFX::VIEW_CONTROLS * PCB_SELECTION_TOOL::controls ( ) const

inlineprotected

Definition at line 272 of file pcb_selection_tool.h.

References TOOL_BASE::getViewControls().

◆ ctrlClickHighlights()

bool PCB_SELECTION_TOOL::ctrlClickHighlights ( )

overrideprotectedvirtual

Determine if ctrl-click is highlight net or XOR selection.

Reimplemented from SELECTION_TOOL.

Definition at line 889 of file pcb_selection_tool.cpp.

References m_frame, and m_isFootprintEditor.

◆ CursorSelection()

int PCB_SELECTION_TOOL::CursorSelection ( const TOOL_EVENT & aEvent )

Definition at line 1723 of file pcb_selection_tool.cpp.

References TOOL_EVENT::Parameter(), and selectCursor().

Referenced by setTransitions().

◆ disambiguateCursor()

int PCB_SELECTION_TOOL::disambiguateCursor ( const TOOL_EVENT & aEvent )

private

Handle disambiguation actions including displaying the menu.

Definition at line 1708 of file pcb_selection_tool.cpp.

References SELECTION_TOOL::m_canceledMenu, SELECTION_TOOL::m_originalCursor, SELECTION_TOOL::m_skip_heuristics, selectPoint(), and SELECTION_TOOL::setModifiersState().

Referenced by setTransitions().

◆ doSelectionMenu()

bool SELECTION_TOOL::doSelectionMenu ( COLLECTOR * aCollector )

protectedinherited

This must be the second time through the loop, and the user has requested the full, non-limited list of selection items

Definition at line 254 of file selection_tool.cpp.

References _, ACTION_MENU::Add(), KIGFX::VIEW::Add(), COLLECTOR::Append(), BRIGHTENED, CMENU_NOW, COLLECTOR::Combine(), EDA_ITEM::DisambiguateItemDescription(), ACTION_MENU::DisplayTitle(), COLLECTOR::Empty(), COLLECTOR::GetCount(), TOOL_BASE::getEditFrame(), EDA_ITEM::GetItemDescription(), EDA_ITEM::GetMenuImage(), TOOL_BASE::getView(), COLLECTOR::HasAdditionalItems(), highlight(), info, INVALID_BITMAP, LAYER_SELECT_OVERLAY, COLLECTOR::m_MenuTitle, TOOL_BASE::m_toolMgr, PCB_FOOTPRINT_T, KIGFX::VIEW::Remove(), TOOL_INTERACTIVE::SetContextMenu(), ACTION_MENU::SetIcon(), KIGFX::VIEW_GROUP::SetLayer(), ACTION_MENU::SetTitle(), TA_CHOICE_MENU_CHOICE, TA_CHOICE_MENU_CLOSED, TA_CHOICE_MENU_UPDATE, EDA_ITEM::Type(), unhighlight(), KIGFX::VIEW::UpdateItems(), and TOOL_INTERACTIVE::Wait().

Referenced by SelectionMenu(), PL_SELECTION_TOOL::SelectPoint(), GERBVIEW_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::selectPoint(), and SCH_SELECTION_TOOL::selectPoint().

◆ doSyncSelection()

void PCB_SELECTION_TOOL::doSyncSelection	(	const std::vector< BOARD_ITEM * > &	aItems,
		bool	aWithNets )

private

Invoke filter dialog and modify current selection.

Definition at line 3073 of file pcb_selection_tool.cpp.

References BOX2< Vec >::Centre(), ClearSelection(), BOX2< Vec >::GetHeight(), BOX2< Vec >::GetWidth(), m_frame, m_selection, TOOL_BASE::m_toolMgr, select(), selectConnections(), EVENTS::SelectedEvent, KIGFX::VIEW::UpdateAllLayersColor(), view(), and ZoomFitCrossProbeBBox().

Referenced by syncSelection(), and syncSelectionWithNets().

◆ editFrame()

PCB_BASE_EDIT_FRAME * PCB_SELECTION_TOOL::editFrame ( ) const

inlineprotected

Definition at line 282 of file pcb_selection_tool.h.

References TOOL_BASE::getEditFrame().

Referenced by selectPoint().

◆ EnterGroup()

void PCB_SELECTION_TOOL::EnterGroup ( )

overridevirtual

Enter the group at the head of the current selection.

Reimplemented from SELECTION_TOOL.

Definition at line 735 of file pcb_selection_tool.cpp.

References ClearSelection(), ENTERED, ExitGroup(), KIGFX::VIEW::Hide(), m_enteredGroup, m_enteredGroupOverlay, m_selection, TOOL_BASE::m_toolMgr, PCB_GROUP_T, select(), EVENTS::SelectedEvent, KIGFX::PCB_VIEW::Update(), and view().

Referenced by Main().

◆ ExitGroup()

void PCB_SELECTION_TOOL::ExitGroup ( bool aSelectGroup = false )

overridevirtual

Leave the currently-entered group.

Parameters

aSelectGroup [optional] Select the group after leaving.

Reimplemented from SELECTION_TOOL.

Definition at line 765 of file pcb_selection_tool.cpp.

References ClearSelection(), ENTERED, KIGFX::VIEW::Hide(), m_enteredGroup, m_enteredGroupOverlay, TOOL_BASE::m_toolMgr, select(), EVENTS::SelectedEvent, KIGFX::PCB_VIEW::Update(), and view().

Referenced by EnterGroup(), Main(), Reset(), select(), and selectPoint().

◆ expandConnection()

int PCB_SELECTION_TOOL::expandConnection ( const TOOL_EVENT & aEvent )

private

Expand the current connected-item selection to the next boundary (junctions, pads, or all)

Definition at line 2137 of file pcb_selection_tool.cpp.

References _, BOARD_CONNECTED_ITEM::ClassOf(), connectedItemFilter(), BOARD_ITEM::IsConnected(), isExpandableGraphicShape(), m_frame, m_selection, TOOL_BASE::m_toolMgr, pad, FOOTPRINT::Pads(), PCB_FOOTPRINT_T, PCB_GENERATOR_T, selectAllConnectedShapes(), selectAllConnectedTracks(), selectCursor(), EVENTS::SelectedEvent, STOP_AT_JUNCTION, STOP_AT_PAD, and STOP_NEVER.

Referenced by setTransitions().

◆ extendTableCellSelectionTo()

bool PCB_SELECTION_TOOL::extendTableCellSelectionTo ( const VECTOR2I & aPosition )

private

If the current selection holds one or more cells from a single PCB_TABLE and the cursor is over another cell in that same table, extend the selection to cover the rectangular range between the original anchor cell and the cell under aPosition.

Returns: true if a range selection was performed; false if the caller should fall back to a normal point selection.

Definition at line 1128 of file pcb_selection_tool.cpp.

References collectTableCellsAt(), end, PCB_TABLE::GetCells(), PCB_SHAPE::GetCenter(), COLLECTOR::GetCount(), BOARD_ITEM::GetParent(), initializeTableCellSelectionState(), SELECTION_TOOL::m_additive, m_previousFirstCell, m_selection, TOOL_BASE::m_toolMgr, selectCellsBetween(), EVENTS::SelectedEvent, unselect(), EVENTS::UnselectedEvent, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by Main().

◆ FilterCollectedItems()

void PCB_SELECTION_TOOL::FilterCollectedItems	(	GENERAL_COLLECTOR &	aCollector,
		bool	aMultiSelect,
		PCB_SELECTION_FILTER_OPTIONS *	aRejected = nullptr )

Apply the SELECTION_FITLER_OPTIONS to the collector.

Definition at line 3494 of file pcb_selection_tool.cpp.

References COLLECTOR::GetCount(), itemPassesFilter(), and COLLECTOR::Remove().

Referenced by BOARD_INSPECTION_TOOL::highlightNet(), PCB_CONTROL::InteractiveDelete(), SelectMultiple(), and selectPoint().

◆ FilterCollectorForFootprints()

void PCB_SELECTION_TOOL::FilterCollectorForFootprints	(	GENERAL_COLLECTOR &	aCollector,
		const VECTOR2I &	aWhere ) const

Drop footprints that are not directly selected.

Definition at line 4917 of file pcb_selection_tool.cpp.

References LSET::AllLayersMask(), board(), BOX2ISafe(), BOX2< Vec >::Contains(), dyn_cast(), COLLECTOR::GetCount(), KIGFX::RENDER_SETTINGS::GetHighContrast(), KIGFX::RENDER_SETTINGS::GetHighContrastLayers(), FOOTPRINT::GetLayer(), FOOTPRINT::GetLayerBoundingBox(), KIGFX::VIEW::GetPainter(), KIGFX::PAINTER::GetSettings(), TOOL_BASE::getView(), KIGFX::VIEW::GetViewport(), BOARD::GetVisibleLayers(), FOOTPRINT::HitTestOnLayer(), SELECTION_TOOL::m_additive, SELECTION_TOOL::m_exclusive_or, m_isFootprintEditor, m_selection, SELECTION_TOOL::m_subtractive, PCB_FOOTPRINT_T, PCB_LAYER_ID_COUNT, COLLECTOR::Remove(), BASE_SET::reset(), BASE_SET::set(), and view().

Referenced by selectPoint().

◆ FilterCollectorForFreePads()

void PCB_SELECTION_TOOL::FilterCollectorForFreePads	(	GENERAL_COLLECTOR &	aCollector,
		bool	aForcePromotion = false ) const

Check the "allow free pads" setting and if disabled, replace any pads in the collector with their parent footprints.

Definition at line 4879 of file pcb_selection_tool.cpp.

References COLLECTOR::Append(), frame(), COLLECTOR::GetCount(), BOARD_ITEM::GetParent(), COLLECTOR::HasItem(), m_isFootprintEditor, PCB_PAD_T, COLLECTOR::Remove(), and EDA_ITEM::Type().

Referenced by EDIT_TOOL::doMoveSelection(), EDIT_TOOL::Drag(), EDIT_TOOL::Duplicate(), EDIT_TOOL::Flip(), EDIT_TOOL::Mirror(), EDIT_TOOL::MoveExact(), EDIT_TOOL::PackAndMoveFootprints(), EDIT_TOOL::Remove(), EDIT_TOOL::Rotate(), and EDIT_TOOL::Swap().

◆ FilterCollectorForHierarchy()

void PCB_SELECTION_TOOL::FilterCollectorForHierarchy	(	GENERAL_COLLECTOR &	aCollector,
		bool	aMultiselect ) const

In general we don't want to select both a parent and any of it's children.

This includes both footprints and their items, and groups and their members.

Definition at line 4786 of file pcb_selection_tool.cpp.

References COLLECTOR::Append(), CANDIDATE, COLLECTOR::GetCount(), EDA_ITEM::GetFlags(), BOARD_ITEM::GetParentFootprint(), COLLECTOR::HasItem(), m_enteredGroup, m_isFootprintEditor, COLLECTOR::Remove(), top(), PCB_GROUP::TopLevelGroup(), and PCB_GROUP::WithinScope().

Referenced by EDIT_TOOL::copyToClipboard(), ARRAY_TOOL::CreateArray(), ALIGN_DISTRIBUTE_TOOL::DistributeItems(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::Drag(), EDIT_TOOL::Duplicate(), EDIT_TOOL::EditVertices(), EDIT_TOOL::Flip(), PCB_CONTROL::InteractiveDelete(), POSITION_RELATIVE_TOOL::InteractiveOffset(), EDIT_TOOL::JustifyText(), EDIT_TOOL::Mirror(), EDIT_TOOL::MoveExact(), EDIT_TOOL::PackAndMoveFootprints(), POSITION_RELATIVE_TOOL::PositionRelative(), EDIT_TOOL::Remove(), GLOBAL_EDIT_TOOL::RemoveUnusedPads(), EDIT_TOOL::Rotate(), SelectAll(), SelectMultiple(), selectPoint(), and EDIT_TOOL::Swap().

◆ FilterCollectorForLockedItems()

void PCB_SELECTION_TOOL::FilterCollectorForLockedItems ( GENERAL_COLLECTOR & aCollector )

In the PCB editor strip out any locked items unless the OverrideLocks checkbox is set.

Definition at line 4756 of file pcb_selection_tool.cpp.

References FRAME_PCB_EDITOR, COLLECTOR::GetCount(), BOARD_ITEM::IsLocked(), m_frame, m_lockedItemsFiltered, RECURSE, COLLECTOR::Remove(), and BOARD_ITEM::RunOnChildren().

Referenced by BOARD_EDITOR_CONTROL::AssignNetclass(), EDIT_TOOL::BooleanPolygons(), EDIT_TOOL::ChangeTrackLayer(), EDIT_TOOL::ChangeTrackWidth(), EDIT_TOOL::copyToClipboard(), ALIGN_DISTRIBUTE_TOOL::DistributeItems(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::Drag(), EDIT_TOOL::EditVertices(), EDIT_TOOL::FilletTracks(), EDIT_TOOL::Flip(), EDIT_TOOL::HealShapes(), EDIT_TOOL::Increment(), POSITION_RELATIVE_TOOL::InteractiveOffset(), EDIT_TOOL::JustifyText(), EDIT_TOOL::Mirror(), EDIT_TOOL::ModifyLines(), EDIT_TOOL::MoveExact(), CONVERT_TOOL::OutsetItems(), EDIT_TOOL::PackAndMoveFootprints(), POSITION_RELATIVE_TOOL::PositionRelative(), EDIT_TOOL::Remove(), EDIT_TOOL::Rotate(), EDIT_TOOL::SimplifyPolygons(), and EDIT_TOOL::Swap().

◆ FilterCollectorForMarkers()

void PCB_SELECTION_TOOL::FilterCollectorForMarkers ( GENERAL_COLLECTOR & aCollector ) const

Drop any PCB_MARKERs from the collector.

Definition at line 4904 of file pcb_selection_tool.cpp.

References COLLECTOR::GetCount(), PCB_MARKER_T, COLLECTOR::Remove(), and EDA_ITEM::Type().

Referenced by EDIT_TOOL::copyToClipboard(), ARRAY_TOOL::CreateArray(), ALIGN_DISTRIBUTE_TOOL::DistributeItems(), EDIT_TOOL::doMoveSelection(), EDIT_TOOL::Duplicate(), EDIT_TOOL::EditVertices(), EDIT_TOOL::Flip(), POSITION_RELATIVE_TOOL::InteractiveOffset(), EDIT_TOOL::Mirror(), EDIT_TOOL::MoveExact(), EDIT_TOOL::PackAndMoveFootprints(), POSITION_RELATIVE_TOOL::PositionRelative(), EDIT_TOOL::Rotate(), and EDIT_TOOL::Swap().

◆ FilterCollectorForTableCells()

void PCB_SELECTION_TOOL::FilterCollectorForTableCells ( GENERAL_COLLECTOR & aCollector ) const

Promote any table cell selections to the whole table.

Definition at line 4856 of file pcb_selection_tool.cpp.

References COLLECTOR::Append(), COLLECTOR::GetCount(), BOARD_ITEM::GetParent(), COLLECTOR::HasItem(), PCB_TABLECELL_T, COLLECTOR::Remove(), and EDA_ITEM::Type().

Referenced by EDIT_TOOL::doMoveSelection(), EDIT_TOOL::Duplicate(), EDIT_TOOL::EditVertices(), EDIT_TOOL::Flip(), EDIT_TOOL::MoveExact(), and EDIT_TOOL::Rotate().

◆ filterSelection()

int PCB_SELECTION_TOOL::filterSelection ( const TOOL_EVENT & aEvent )

private

Return true if the given item passes the current SELECTION_FILTER_OPTIONS.

Definition at line 3459 of file pcb_selection_tool.cpp.

References board(), ClearSelection(), TOOL_BASE::getModel(), itemIsIncludedByFilter(), m_frame, m_priv, m_selection, TOOL_BASE::m_toolMgr, select(), EVENTS::SelectedEvent, selection(), and DIALOG_SHIM::ShowModal().

Referenced by setTransitions().

◆ FindItem()

void PCB_SELECTION_TOOL::FindItem ( BOARD_ITEM * aItem )

Take necessary actions to mark an item as found.

Parameters

aItem The item that was found and needs to be highlighted/focused/etc.

Definition at line 3329 of file pcb_selection_tool.cpp.

References BOX2ISafe(), canvas(), EVENTS::ClearedEvent, ClearSelection(), BOX2< Vec >::Contains(), EDA_ITEM::GetBoundingBox(), BOARD_ITEM::GetCenter(), BOX2< Vec >::GetHeight(), BOX2< Vec >::GetOrigin(), EDA_ITEM::GetPosition(), KIGFX::VIEW::GetScale(), BOX2< Vec >::GetSize(), PCB_DRAW_PANEL_GAL::GetView(), KIGFX::VIEW::GetViewport(), BOX2< Vec >::GetWidth(), m_frame, m_selection, TOOL_BASE::m_toolMgr, PCB_NETINFO_T, scale, select(), SelectAllItemsOnNet(), EVENTS::SelectedEvent, KIGFX::VIEW::SetScale(), EDA_ITEM::Type(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PCB_EDIT_FRAME::ShowFindDialog().

◆ frame()

PCB_BASE_FRAME * PCB_SELECTION_TOOL::frame ( ) const

inlineprotected

Definition at line 277 of file pcb_selection_tool.h.

References TOOL_BASE::getEditFrame().

Referenced by canvas(), FilterCollectorForFreePads(), Init(), Main(), and Selectable().

◆ GetActiveLayer()

PCB_LAYER_ID PCB_SELECTION_TOOL::GetActiveLayer ( )

inline

Definition at line 217 of file pcb_selection_tool.h.

References m_frame.

◆ getCollectorsGuide()

const GENERAL_COLLECTORS_GUIDE PCB_SELECTION_TOOL::getCollectorsGuide ( ) const

private

Definition at line 863 of file pcb_selection_tool.cpp.

Referenced by collectTableCellsAt(), RequestSelection(), selectAllConnectedShapes(), and selectPoint().

◆ getEditFrame()

template<typename T>

T * TOOL_BASE::getEditFrame ( ) const

inlineprotectedinherited

Return the application window object, casted to requested user type.

Definition at line 182 of file tool_base.h.

References getToolHolderInternal(), and T.

◆ GetEnteredGroup()

PCB_GROUP * PCB_SELECTION_TOOL::GetEnteredGroup ( )

inline

Returns: the currently-entered group.

Definition at line 215 of file pcb_selection_tool.h.

References m_enteredGroup.

Referenced by PNS_KICAD_IFACE::Commit(), PCB_CONTROL::placeBoardItems(), and BOARD_COMMIT::Push().

◆ GetFilter()

PCB_SELECTION_FILTER_OPTIONS & PCB_SELECTION_TOOL::GetFilter ( )

inline

Set up handlers for various events.

Definition at line 186 of file pcb_selection_tool.h.

References m_filter.

Referenced by BOARD_INSPECTION_TOOL::highlightNet(), and PCB_EDIT_FRAME::LoadProjectSettings().

◆ GetId()

TOOL_ID TOOL_BASE::GetId ( ) const

inlineinherited

Return the unique identifier of the tool.

The identifier is set by an instance of TOOL_MANAGER.

Returns: Identifier of the tool.

Definition at line 119 of file tool_base.h.

References m_toolId.

Referenced by TOOL_MANAGER::finishTool(), TOOL_MANAGER::InitTools(), TOOL_MANAGER::isActive(), TOOL_MANAGER::RegisterTool(), ACTION_MANAGER::RunHotKey(), TOOL_MANAGER::runTool(), TOOL_MANAGER::saveViewControls(), and TOOL_MANAGER::ShutdownTool().

◆ GetManager()

TOOL_MANAGER * TOOL_BASE::GetManager ( ) const

inlineinherited

Return the instance of TOOL_MANAGER that takes care of the tool.

Returns: Instance of the TOOL_MANAGER or NULL if there is no associated tool manager.

Definition at line 142 of file tool_base.h.

References m_toolMgr, and TOOL_MANAGER.

Referenced by MULTICHANNEL_TOOL::AutogenerateRuleAreas(), PCB_TOOL_BASE::doInteractiveItemPlacement(), PCB_TUNING_PATTERN::EditCancel(), PCB_TUNING_PATTERN::EditFinish(), PCB_TUNING_PATTERN::EditStart(), makeShapeModificationMenu(), PAD_TOOL::PlacePad(), MULTICHANNEL_TOOL::RepeatLayout(), MULTICHANNEL_TOOL::RepeatLayout(), SCH_COMMIT::SCH_COMMIT(), PCB_TUNING_PATTERN::Update(), and GLOBAL_EDIT_TOOL::ZonesManager().

◆ getModel()

template<typename T>

T * TOOL_BASE::getModel ( ) const

inlineprotectedinherited

Return the model object if it matches the requested type.

Definition at line 195 of file tool_base.h.

References getModelInternal(), and T.

◆ getModelInternal()

EDA_ITEM * TOOL_BASE::getModelInternal ( ) const

privateinherited

Definition at line 52 of file tool_base.cpp.

References m_toolMgr.

Referenced by getModel().

◆ GetName()

const std::string & TOOL_BASE::GetName ( ) const

inlineinherited

Return the name of the tool.

Tool names are expected to obey the format: application.ToolName (eg. pcbnew.InteractiveSelection).

Returns: The name of the tool.

Definition at line 132 of file tool_base.h.

References m_toolName.

Referenced by PCB_CONTROL::AppendBoard(), TOOL_MANAGER::dispatchInternal(), COMMON_TOOLS::GridProperties(), TOOL_MANAGER::InitTools(), TOOL_MANAGER::invokeTool(), TOOL_MANAGER::RegisterTool(), TOOL_MANAGER::ResetTools(), TOOL_MANAGER::runTool(), SCH_TOOL_BASE< SCH_EDIT_FRAME >::SetContextMenu(), and TOOL_MANAGER::ShutdownTool().

◆ GetSelection()

PCB_SELECTION & PCB_SELECTION_TOOL::GetSelection ( )

Returns: the set of currently selected items.

Definition at line 787 of file pcb_selection_tool.cpp.

References m_selection.

Referenced by PCB_CONTROL::AppendBoard(), PCB_CONTROL::ApplyDesignBlockLayout(), BOARD_INSPECTION_TOOL::calculateSelectionRatsnest(), PAD_TOOL::copyPadSettings(), ZONE_CREATE_HELPER::createNewZone(), DRC_TOOL::CrossProbe(), BOARD_EDITOR_CONTROL::doCrossProbePcbToSch(), BOARD_INSPECTION_TOOL::doHideRatsnestNet(), EDIT_TOOL::Drag(), GATE_SWAP_MENU::eventHandler(), EDIT_TOOL::GetAndPlace(), PCB_PROPERTIES_PANEL::getSelection(), DRAWING_TOOL::getSourceZoneForAction(), API_HANDLER_BOARD::handleAddToSelection(), API_HANDLER_BOARD::handleGetSelection(), API_HANDLER_BOARD::handleInteractiveMoveItems(), API_HANDLER_BOARD::handleRemoveFromSelection(), API_HANDLER_BOARD::handleSaveSelectionToString(), BOARD_INSPECTION_TOOL::highlightNet(), BOARD_INSPECTION_TOOL::InspectClearance(), BOARD_INSPECTION_TOOL::InspectConstraints(), BOARD_INSPECTION_TOOL::LocalRatsnestTool(), Main(), PCB_CONTROL::Paste(), PAD_TOOL::pastePadProperties(), PCB_CONTROL::placeBoardItems(), PCB_CONTROL::PlaceLinkedDesignBlock(), DRAWING_TOOL::PlaceReferenceImage(), PAD_TOOL::pushPadSettings(), DIALOG_FIND_BY_PROPERTIES::rebuildPropertyGrid(), PCB_CONTROL::SaveToLinkedDesignBlock(), PCB_TOOL_BASE::selection(), PCB_TOOL_BASE::selection(), SelectPolyArea(), BOARD_INSPECTION_TOOL::ShowFootprintLinks(), GATE_SWAP_MENU::update(), REPLACE_TERMINAL_PAD_MENU::update(), ZONE_PRIORITY_CONTEXT_MENU::update(), PCB_CONTROL::UpdateMessagePanel(), BOARD_EDITOR_CONTROL::ZoneDuplicate(), DIALOG_IMPORT_NETLIST::~DIALOG_IMPORT_NETLIST(), and DIALOG_UPDATE_PCB::~DIALOG_UPDATE_PCB().

◆ getToolHolderInternal()

TOOLS_HOLDER * TOOL_BASE::getToolHolderInternal ( ) const

privateinherited

Definition at line 46 of file tool_base.cpp.

References m_toolMgr.

Referenced by getEditFrame().

◆ GetToolMenu()

TOOL_MENU & TOOL_INTERACTIVE::GetToolMenu ( )

inherited

Definition at line 108 of file tool_interactive.cpp.

References m_menu.

Referenced by BOARD_EDITOR_CONTROL::Init(), BOARD_INSPECTION_TOOL::Init(), FOOTPRINT_CHOOSER_SELECTION_TOOL::Init(), GENERATOR_TOOL::Init(), PAD_TOOL::Init(), PCB_EDIT_TABLE_TOOL::Init(), SCH_EDIT_TOOL::Init(), and SYMBOL_EDITOR_EDIT_TOOL::Init().

◆ GetType()

TOOL_TYPE TOOL_BASE::GetType ( ) const

inlineinherited

Return the type of the tool.

Returns: The type of the tool.

Definition at line 107 of file tool_base.h.

References m_type.

Referenced by TOOL_MANAGER::InvokeTool(), TOOL_MANAGER::InvokeTool(), TOOL_MANAGER::ResetTools(), TOOL_MANAGER::runTool(), TOOL_MANAGER::ShutdownTool(), and TOOL_MANAGER::ShutdownTool().

◆ getView()

KIGFX::VIEW * TOOL_BASE::getView ( ) const

protectedinherited

Returns the instance of #VIEW object used in the application.

It allows tools to draw.

Returns: The instance of VIEW.

Definition at line 34 of file tool_base.cpp.

References m_toolMgr.

◆ getViewControls()

KIGFX::VIEW_CONTROLS * TOOL_BASE::getViewControls ( ) const

protectedinherited

Return the instance of VIEW_CONTROLS object used in the application.

It allows tools to read & modify user input and its settings (eg. show cursor, enable snapping to grid, etc.).

Returns: The instance of VIEW_CONTROLS.

Definition at line 40 of file tool_base.cpp.

References m_toolMgr.

Referenced by PCB_POINT_EDITOR::addCorner(), SCH_SELECTION_TOOL::autostartEvent(), PCB_POINT_EDITOR::chamferCorner(), PCB_SELECTION_TOOL::controls(), PCB_TEST_SELECTION_TOOL::controls(), PCB_TOOL_BASE::controls(), EDIT_TOOL::copyToClipboard(), COMMON_TOOLS::CursorControl(), EDIT_TOOL::DeleteItems(), EDIT_TOOL::doMoveSelection(), COMMON_TOOLS::doZoomToPreset(), DRAWING_TOOL::DrawBarcode(), DRAWING_TOOL::DrawLine(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::DrawRectangle(), PL_DRAWING_TOOLS::DrawShape(), DRAWING_TOOL::drawShape(), DRAWING_TOOL::DrawTable(), DRAWING_TOOL::DrawZone(), PAD_TOOL::EnumeratePads(), BOARD_INSPECTION_TOOL::HighlightNet(), BOARD_INSPECTION_TOOL::HighlightNetChain(), FOOTPRINT_EDITOR_CONTROL::ImportFootprint(), SCH_TOOL_BASE< T >::Increment(), EDIT_TOOL::Init(), POSITION_RELATIVE_TOOL::InteractiveOffset(), PCB_PICKER_TOOL::Main(), PICKER_TOOL::Main(), PL_EDIT_TOOL::Main(), PL_POINT_EDITOR::Main(), SCH_SELECTION_TOOL::Main(), ROUTER_TOOL::MainLoop(), PCB_POINT_EDITOR::makePoints(), GERBVIEW_INSPECTION_TOOL::MeasureTool(), PCB_VIEWER_TOOLS::MeasureTool(), COMMON_TOOLS::OnGridChanged(), PCB_POINT_EDITOR::OnSelectionChange(), ROUTER_TOOL::performDragging(), ROUTER_TOOL::performRouting(), PCB_CONTROL::placeBoardItems(), BOARD_EDITOR_CONTROL::PlaceFootprint(), PL_DRAWING_TOOLS::PlaceItem(), DRAWING_TOOL::PlaceReferenceImage(), DRAWING_TOOL::PlaceTuningPattern(), EDIT_TOOL::Properties(), PL_SELECTION_TOOL::RequestSelection(), SCH_SELECTION_TOOL::RequestSelection(), DIFF_PHASE_SKEW_TOOL::Reset(), DRAWING_TOOL::Reset(), PCB_POINT_EDITOR::Reset(), COMMON_TOOLS::ResetLocalCoords(), ROUTER_TOOL::RouteSelected(), DRAWING_TOOL::runSimpleShapeDraw(), PCB_SELECTION_TOOL::selectCursor(), SCH_SELECTION_TOOL::selectLasso(), PL_SELECTION_TOOL::selectMultiple(), SCH_SELECTION_TOOL::selectMultiple(), SCH_SELECTION_TOOL::SelectNode(), PCB_SELECTION_TOOL::SelectPolyArea(), PCB_SELECTION_TOOL::SelectRectArea(), ZOOM_TOOL::selectRegion(), PCB_SELECTION_TOOL::selectTableCells(), SCH_SELECTION_TOOL::selectTableCells(), ALIGN_DISTRIBUTE_TOOL::selectTarget(), PCB_PICKER_TOOL::setControls(), PICKER_TOOL::setControls(), PCB_POINT_EDITOR::setEditedPoint(), PL_POINT_EDITOR::setEditedPoint(), DIFF_PHASE_SKEW_TOOL::ShowDiffPhaseSkew(), PCB_POINT_EDITOR::updateEditedPoint(), PL_POINT_EDITOR::updateEditedPoint(), PL_EDIT_TOOL::updateModificationPoint(), and COMMON_TOOLS::ZoomCenter().

◆ Go()

template<class T>

void TOOL_INTERACTIVE::Go	(	int(T::*	aStateFunc )(const TOOL_EVENT &),
		const TOOL_EVENT_LIST &	aConditions = TOOL_EVENT( TC_ANY, TA_ANY ) )

inherited

Define which state (aStateFunc) to go when a certain event arrives (aConditions).

No conditions means any event.

Definition at line 143 of file tool_interactive.h.

References goInternal(), and T.

◆ goInternal()

void TOOL_INTERACTIVE::goInternal	(	TOOL_STATE_FUNC &	aState,
		const TOOL_EVENT_LIST &	aConditions )

privateinherited

Definition at line 80 of file tool_interactive.cpp.

Referenced by Go().

◆ grabUnconnected()

int PCB_SELECTION_TOOL::grabUnconnected ( const TOOL_EVENT & aEvent )

private

Select and move other nearest footprint unconnected on same net as selected items.

Definition at line 2726 of file pcb_selection_tool.cpp.

References anchor, board(), ClearSelection(), BOARD::GetConnectivity(), RN_NET::GetEdges(), BOARD_ITEM::GetParentFootprint(), m_selection, TOOL_BASE::m_toolMgr, PCB_ACTIONS::moveIndividually, pad, CN_ANCHOR::Parent(), PCB_FOOTPRINT_T, PCB_PAD_T, select(), and EDA_ITEM::Type().

Referenced by setTransitions().

◆ GuessSelectionCandidates()

void PCB_SELECTION_TOOL::GuessSelectionCandidates	(	GENERAL_COLLECTOR &	aCollector,
		const VECTOR2I &	aWhere ) const

Try to guess best selection candidates in case multiple items are clicked, by doing some brain-dead heuristics.

Parameters

aCollector	[in, out] The collector that has a list of items to be narrowed.
aWhere	The selection point to consider.

Definition at line 4549 of file pcb_selection_tool.cpp.

References COLLECTOR::Append(), B_CrtYd, B_SilkS, COLLECTOR::Empty(), F_CrtYd, F_SilkS, EDA_ITEM::GetBoundingBox(), ADVANCED_CFG::GetCfg(), COLLECTOR::GetCount(), FOOTPRINT::GetCoverageArea(), GENERAL_COLLECTOR::GetGuide(), BOX2< Vec >::GetHeight(), KIGFX::RENDER_SETTINGS::GetHighContrast(), BOARD_ITEM::GetLayer(), KIGFX::VIEW::GetPainter(), KIGFX::PAINTER::GetSettings(), TOOL_BASE::getView(), BOX2< Vec >::GetWidth(), hitTestDistance(), ZONE::HitTestForEdge(), EDA_ITEM::IsType(), KiROUND(), m_frame, COLLECTORS_GUIDE::OnePixelInIU(), PCB_BARCODE_T, PCB_FIELD_T, PCB_FOOTPRINT_T, PCB_REFERENCE_IMAGE_T, PCB_SHAPE_T, PCB_TABLE_T, PCB_TABLECELL_T, PCB_TEXT_T, PCB_TEXTBOX_T, PCB_VIA_T, PCB_ZONE_T, pruneObscuredSelectionCandidates(), SEG::Square(), COLLECTOR::Transfer(), EDA_ITEM::Type(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by DIFF_PHASE_SKEW_TOOL::doInitialHover(), EDIT_TOOL::Drag(), PCB_CONTROL::InteractiveDelete(), BOARD_INSPECTION_TOOL::pickItemForInspection(), DRAWING_TOOL::PlaceTuningPattern(), and selectPoint().

◆ hasModifier()

bool SELECTION_TOOL::hasModifier ( )

protectedinherited

True if a selection modifier is enabled, false otherwise.

Definition at line 83 of file selection_tool.cpp.

References m_additive, m_exclusive_or, and m_subtractive.

Referenced by PCB_SELECTION_TOOL::Main(), PL_SELECTION_TOOL::Main(), SCH_SELECTION_TOOL::Main(), and onDisambiguationExpire().

◆ highlight()

void PCB_SELECTION_TOOL::highlight	(	EDA_ITEM *	aItem,
		int	aHighlightMode,
		SELECTION *	aGroup = nullptr )

overrideprivatevirtual

Highlight the item visually.

Parameters

aItem	The item to be highlighted.
aHighlightMode	Either SELECTED or BRIGHTENED
aGroup	[optional A group to add the item to.

Implements SELECTION_TOOL.

Definition at line 4143 of file pcb_selection_tool.cpp.

References SELECTION::Add(), BRIGHTENED, TOOL_BASE::getView(), highlightInternal(), KIGFX::VIEW::MarkTargetDirty(), KIGFX::REPAINT, KIGFX::TARGET_OVERLAY, KIGFX::PCB_VIEW::Update(), and view().

Referenced by RebuildSelection(), RequestSelection(), and select().

◆ highlightInternal()

void PCB_SELECTION_TOOL::highlightInternal	(	EDA_ITEM *	aItem,
		int	aHighlightMode,
		bool	aUsingOverlay )

private

Definition at line 4158 of file pcb_selection_tool.cpp.

References BRIGHTENED, KIGFX::VIEW::Hide(), highlightInternal(), KIGFX::VIEW_ITEM::IsBOARD_ITEM(), RECURSE, BOARD_ITEM::RunOnChildren(), SELECTED, EDA_ITEM::SetBrightened(), EDA_ITEM::SetSelected(), and view().

Referenced by highlight(), and highlightInternal().

◆ hitTestDistance()

int PCB_SELECTION_TOOL::hitTestDistance	(	const VECTOR2I &	aWhere,
		BOARD_ITEM *	aItem,
		int	aMaxDistance ) const

private

Returns: the distance from aWhere to aItem, up to and including aMaxDistance.

Definition at line 4254 of file pcb_selection_tool.cpp.

References BOX2ISafe(), SHAPE::Collide(), SHAPE_LINE_CHAIN::Collide(), SHAPE_POLY_SET::Collide(), distance(), FOOTPRINT::GetBoundingBox(), FOOTPRINT::GetBoundingHull(), BOARD_ITEM::GetEffectiveShape(), EDA_TEXT::GetEffectiveTextShape(), BOX2< Vec >::GetHeight(), MARKER_BASE::GetPos(), TOOL_BASE::getView(), KIGFX::VIEW::GetViewport(), BOX2< Vec >::GetWidth(), group, hitTestDistance(), ZONE::HitTestForEdge(), EDA_SHAPE::MakeEffectiveShapesForHitTesting(), SHAPE_LINE_CHAIN::Move(), PCB_FIELD_T, PCB_FOOTPRINT_T, PCB_GENERATOR_T, PCB_GROUP_T, PCB_MARKER_T, PCB_PAD_T, PCB_TABLE_T, PCB_TABLECELL_T, PCB_TEXT_T, PCB_TEXTBOX_T, PCB_ZONE_T, MARKER_BASE::ShapeToPolygon(), table, text, and EDA_ITEM::Type().

Referenced by GuessSelectionCandidates(), and hitTestDistance().

◆ Init()

bool PCB_SELECTION_TOOL::Init ( )

overridevirtual

Init() is called once upon a registration of the tool.

Returns: True if the initialization went fine, false - otherwise.

Reimplemented from TOOL_BASE.

Definition at line 257 of file pcb_selection_tool.cpp.

References PCB_ACTIONS::applyDesignBlockLayout, ACTIONS::cancelInteractive, PCB_ACTIONS::clearHighlight, SELECTION_CONDITIONS::Count(), frame(), FRAME_FOOTPRINT_VIEWER, FRAME_PCB_EDITOR, TOOL_BASE::getEditFrame(), KIGFX::RENDER_SETTINGS::GetHighlightNetCodes(), ACTIONS::groupEnter, ACTIONS::groupLeave, EDA_GROUP::HasDesignBlockLink(), SELECTION_CONDITIONS::HasType(), SELECTION_TOOL::m_disambiguateTimer, m_enteredGroup, TOOL_INTERACTIVE::m_menu, TOOL_BASE::m_toolMgr, SELECTION_CONDITIONS::MoreThan(), SELECTION_CONDITIONS::NotEmpty(), SELECTION_TOOL::onDisambiguationExpire(), SELECTION_CONDITIONS::OnlyTypes(), PCB_ARC_T, PCB_GROUP_T, PCB_PAD_T, PCB_TABLECELL_T, PCB_TRACE_T, PCB_VIA_T, PCB_ACTIONS::placeLinkedDesignBlock, PCB_ACTIONS::saveToLinkedDesignBlock, ACTIONS::selectColumns, ACTIONS::selectRows, ACTIONS::selectTable, tableCellTypes, TOOLS_HOLDER::ToolStackIsEmpty(), and EDA_ITEM::Type().

◆ initializeTableCellSelectionState()

void PCB_SELECTION_TOOL::initializeTableCellSelectionState ( PCB_TABLE * aTable )

private

Mark the existing selection state of table cells so that drag- and shift-click range selection can preserve previously-selected cells.

Definition at line 1078 of file pcb_selection_tool.cpp.

References CANDIDATE, and PCB_TABLE::GetCells().

Referenced by extendTableCellSelectionTo(), and selectTableCells().

◆ isExpandableGraphicShape()

bool PCB_SELECTION_TOOL::isExpandableGraphicShape ( const EDA_ITEM * aItem ) const

private

Returns: true if the given item is an open PCB_SHAPE on a non-copper layer

Definition at line 2604 of file pcb_selection_tool.cpp.

References ARC, BEZIER, EDA_SHAPE::GetShape(), EDA_SHAPE::IsClosed(), BOARD_ITEM::IsOnCopperLayer(), PCB_SHAPE_T, POLY, SEGMENT, and EDA_ITEM::Type().

Referenced by expandConnection(), and selectAllConnectedShapes().

◆ IsFootprintEditor()

bool PCB_SELECTION_TOOL::IsFootprintEditor ( )

inline

Definition at line 76 of file pcb_selection_tool.h.

References m_isFootprintEditor.

◆ IsToolActive()

bool TOOL_BASE::IsToolActive ( ) const

inherited

Definition at line 28 of file tool_base.cpp.

References m_toolId, and m_toolMgr.

Referenced by EDIT_TOOL::ChangeTrackLayer(), EDIT_TOOL::Drag(), ROUTER_TOOL::handleLayerSwitch(), EDIT_TOOL::invokeInlineRouter(), PCB_SELECTION_TOOL::Main(), BOARD_EDITOR_CONTROL::TrackWidthDec(), and BOARD_EDITOR_CONTROL::TrackWidthInc().

◆ itemPassesFilter()

bool PCB_SELECTION_TOOL::itemPassesFilter	(	BOARD_ITEM *	aItem,
		bool	aMultiSelect,
		PCB_SELECTION_FILTER_OPTIONS *	aRejected = nullptr )

private

Definition at line 3518 of file pcb_selection_tool.cpp.

Referenced by FilterCollectedItems(), SelectAll(), selectAllConnectedShapes(), selectAllConnectedTracks(), and SelectAllItemsOnNet().

◆ Main()

int PCB_SELECTION_TOOL::Main ( const TOOL_EVENT & aEvent )

The main loop.

Definition at line 409 of file pcb_selection_tool.cpp.

References accuracy, ARROW, BUT_LEFT, BUT_MIDDLE, BUT_RIGHT, BOARD_INSPECTION_TOOL::ClearHighlight(), ClearSelection(), collectTableCellsAt(), delta, DRAG, PCB_ACTIONS::drag45Degree, DRAG_ANY, DRAG_FREE_ANGLE, DRAG_SELECTED, PCB_ACTIONS::dragFreeAngle, EnterGroup(), ExitGroup(), extendTableCellSelectionTo(), frame(), FRAME_FOOTPRINT_VIEWER, FRAME_PCB_EDITOR, ADVANCED_CFG::GetCfg(), COLLECTOR::GetCount(), TOOL_BASE::getEditFrame(), GetSelection(), SELECTION_TOOL::hasModifier(), PCB_POINT_EDITOR::HasPoint(), PCB_ACTIONS::highlightNet, ZONE::HitTestForCorner(), ZONE::HitTestForEdge(), ACTIONS::increment, EVENTS::InhibitSelectionEditing, INSIDE_LASSO, INSIDE_RECTANGLE, IS_MOVING, IS_NEW, TOOL_BASE::IsToolActive(), SELECTION_TOOL::m_canceledMenu, SELECTION_TOOL::m_disambiguateTimer, m_enteredGroup, m_frame, SELECTION_TOOL::m_highlight_modifier, TOOL_INTERACTIVE::m_menu, m_nonModifiedCursor, SELECTION_TOOL::m_originalCursor, m_previousFirstCell, m_selection, m_selectionMode, TOOL_BASE::m_toolMgr, MD_ALT, MD_CTRL, MD_SHIFT, MOVE, PCB_ACTIONS::move, MOVING, SELECTION_CONDITIONS::OnlyTypes(), PCB_ARC_T, PCB_GROUP_T, PCB_SELECTION_TOOL(), PCB_TRACE_T, PCB_VIA_T, PCB_ZONE_T, PCB_ACTIONS::properties, ROUTER_TOOL::RoutingInProgress(), SELECT, selectionContains(), selectPoint(), SelectPolyArea(), SelectRectArea(), selectTableCells(), SELECTION_TOOL::setModifiersState(), singleSelectedCell(), TA_MOUSE_WHEEL, toggleTableCellSelection(), TOUCHING_LASSO, TOUCHING_RECTANGLE, TOOL_INTERACTIVE::Wait(), ACTIONS::zoomFitObjects, and ACTIONS::zoomFitScreen.

Referenced by setTransitions().

◆ onDisambiguationExpire()

void SELECTION_TOOL::onDisambiguationExpire ( wxTimerEvent & aEvent )

protectedinherited

Start the process to show our disambiguation menu once the user has kept the mouse down for the minimum time.

Parameters

aEvent

Definition at line 228 of file selection_tool.cpp.

References EVENTS::DisambiguatePoint, TOOL_BASE::getEditFrame(), hasModifier(), TOOL_BASE::m_toolMgr, and selection().

Referenced by PCB_SELECTION_TOOL::Init(), PL_SELECTION_TOOL::Init(), SCH_SELECTION_TOOL::Init(), and PCB_SELECTION_TOOL::~PCB_SELECTION_TOOL().

◆ OnIdle()

void PCB_SELECTION_TOOL::OnIdle ( wxIdleEvent & aEvent )

Definition at line 389 of file pcb_selection_tool.cpp.

References ADD, SELECTION_TOOL::m_additive, SELECTION_TOOL::m_exclusive_or, m_frame, SELECTION_TOOL::m_multiple, m_nonModifiedCursor, SELECTION_TOOL::m_subtractive, SELECTION_TOOL::setModifiersState(), SUBTRACT, and XOR.

Referenced by PCB_BASE_EDIT_FRAME::PCB_BASE_EDIT_FRAME().

◆ pruneObscuredSelectionCandidates()

void PCB_SELECTION_TOOL::pruneObscuredSelectionCandidates ( GENERAL_COLLECTOR & aCollector ) const

private

◆ RebuildSelection()

void PCB_SELECTION_TOOL::RebuildSelection ( )

Rebuild the selection from the EDA_ITEMs' selection flags.

Commonly called after rolling back an undo state to make sure there aren't any stale pointers.

Definition at line 3745 of file pcb_selection_tool.cpp.

References GENERAL_COLLECTOR::AllBoardItems, board(), EDA_ITEM::ClearFlags(), CONTINUE, ENTERED, GENERAL_COLLECTOR::FootprintItems, EDA_ITEM::GetParent(), highlight(), EDA_ITEM::IsSelected(), m_enteredGroup, m_enteredGroupOverlay, m_isFootprintEditor, m_previousFirstCell, m_selection, PCB_GROUP_T, SELECTED, EDA_ITEM::SetFlags(), EDA_ITEM::Type(), and BOARD::Visit().

Referenced by PCB_BASE_EDIT_FRAME::PutDataInPreviousState(), and BOARD_COMMIT::Revert().

◆ RemoveItemFromSel() [1/2]

int SELECTION_TOOL::RemoveItemFromSel ( const TOOL_EVENT & aEvent )

inherited

Definition at line 159 of file selection_tool.cpp.

References TOOL_EVENT::Parameter(), RemoveItemFromSel(), selection(), and SELECTION::SetIsHover().

Referenced by SCHEMATIC::CleanUp(), SCH_SELECTION_TOOL::FilterSelectionForLockedItems(), BOARD_COMMIT::Push(), SCH_COMMIT::pushSchEdit(), RemoveItemFromSel(), ReselectItem(), PCB_SELECTION_TOOL::setTransitions(), PL_SELECTION_TOOL::setTransitions(), and SCH_SELECTION_TOOL::setTransitions().

◆ RemoveItemFromSel() [2/2]

void SELECTION_TOOL::RemoveItemFromSel	(	EDA_ITEM *	aItem,
		bool	aQuietMode = false )

inherited

Definition at line 167 of file selection_tool.cpp.

References TOOL_BASE::m_toolMgr, unselect(), and EVENTS::UnselectedEvent.

◆ RemoveItemsFromSel() [1/3]

int SELECTION_TOOL::RemoveItemsFromSel ( const TOOL_EVENT & aEvent )

inherited

Definition at line 180 of file selection_tool.cpp.

References TOOL_EVENT::Parameter(), RemoveItemsFromSel(), selection(), and SELECTION::SetIsHover().

Referenced by API_HANDLER_BOARD::handleRemoveFromSelection(), RemoveItemsFromSel(), RemoveItemsFromSel(), PCB_SELECTION_TOOL::setTransitions(), PL_SELECTION_TOOL::setTransitions(), and SCH_SELECTION_TOOL::setTransitions().

◆ RemoveItemsFromSel() [2/3]

void SELECTION_TOOL::RemoveItemsFromSel	(	EDA_ITEMS *	aList,
		bool	aQuietMode = false )

inherited

Definition at line 188 of file selection_tool.cpp.

References TOOL_BASE::m_toolMgr, unselect(), and EVENTS::UnselectedEvent.

◆ RemoveItemsFromSel() [3/3]

void SELECTION_TOOL::RemoveItemsFromSel	(	std::vector< KIID > *	aList,
		bool	aQuietMode = false )

inherited

A safer version of RemoveItemsFromSel( EDA_ITEMS ) which doesn't require the items to still exist.

Definition at line 202 of file selection_tool.cpp.

References alg::contains(), RemoveItemsFromSel(), and selection().

◆ ReportFilteredLockedItems()

void PCB_SELECTION_TOOL::ReportFilteredLockedItems ( )

If the most recent FilterCollectorForLockedItems call removed at least one item, show an InfoBar warning prompting the user to enable Override Locks.

No-op otherwise.

Definition at line 4745 of file pcb_selection_tool.cpp.

References _, m_frame, and m_lockedItemsFiltered.

◆ RequestSelection()

PCB_SELECTION & PCB_SELECTION_TOOL::RequestSelection ( CLIENT_SELECTION_FILTER aClientFilter )

Return the current selection, filtered according to aClientFilter.

If the set is empty, performs the legacy-style hover selection.

Parameters

aClientFilter A callback to allow tool- or action-specific filtering. Select a single item under cursor event handler.

Definition at line 793 of file pcb_selection_tool.cpp.

References COLLECTOR::Append(), BOTH, getCollectorsGuide(), highlight(), m_frame, m_lockedItemsFiltered, m_selection, TOOL_BASE::m_toolMgr, SELECTED, ACTIONS::selectionCursor, GENERAL_COLLECTOR::SetGuide(), and unhighlight().

Referenced by BOARD_EDITOR_CONTROL::AssignNetclass(), ARRAY_TOOL::CreateArray(), BOARD_INSPECTION_TOOL::DiffFootprint(), BOARD_EDITOR_CONTROL::EditFpInFpEditor(), PCB_EDIT_TABLE_TOOL::getTableCellSelection(), PCB_GROUP_TOOL::Group(), BOARD_EDITOR_CONTROL::modifyLockSelected(), PCB_GROUP_TOOL::PickNewMember(), GENERATOR_TOOL::RegenerateSelected(), and PCB_PICKER_TOOL::SelectItemInteractively().

◆ ReselectItem()

int SELECTION_TOOL::ReselectItem ( const TOOL_EVENT & aEvent )

inherited

Definition at line 125 of file selection_tool.cpp.

References AddItemToSel(), TOOL_EVENT::Parameter(), RemoveItemFromSel(), selection(), and SELECTION::SetIsHover().

Referenced by PCB_SELECTION_TOOL::setTransitions().

◆ Reset()

void PCB_SELECTION_TOOL::Reset ( RESET_REASON aReason )

overridevirtual

Bring the tool to a known, initial state.

If the tool claimed anything from the model or the view, it must release it when its reset.

Parameters

aReason contains information about the reason of tool reset.

Implements TOOL_BASE.

Definition at line 362 of file pcb_selection_tool.cpp.

References KIGFX::PCB_VIEW::Add(), ClearSelection(), ExitGroup(), FRAME_FOOTPRINT_EDITOR, TOOL_BASE::getEditFrame(), KIGFX::VIEW::GetPainter(), KIGFX::PAINTER::GetSettings(), TOOL_BASE::getView(), m_enteredGroup, m_enteredGroupOverlay, m_frame, m_isFootprintEditor, m_selection, TOOL_BASE::MODEL_RELOAD, TOOL_BASE::REDRAW, KIGFX::PCB_VIEW::Remove(), KIGFX::RENDER_SETTINGS::SetHighlight(), and view().

◆ resetTransitions()

void TOOL_INTERACTIVE::resetTransitions ( )

privateinherited

Clear the current transition map and restores the default one created by setTransitions().

Definition at line 73 of file tool_interactive.cpp.

◆ RunMainStack()

void TOOL_INTERACTIVE::RunMainStack ( std::function< void()> aFunc )

inherited

Call a function using the main stack.

Parameters

aFunc is the function to be calls.

Definition at line 102 of file tool_interactive.cpp.

Referenced by DRAWING_TOOL::DrawBarcode(), DRAWING_TOOL::DrawTable(), KICAD_MANAGER_CONTROL::NewProject(), DRAWING_TOOL::PlaceReferenceImage(), DRAWING_TOOL::PlaceText(), BOARD_EDITOR_CONTROL::ShowEeschema(), and BOARD_EDITOR_CONTROL::UpdatePCBFromSchematic().

◆ select()

void PCB_SELECTION_TOOL::select ( EDA_ITEM * aItem )

overridevirtual

Take necessary action mark an item as selected.

Parameters

aItem The item to be selected.

Implements SELECTION_TOOL.

Definition at line 4114 of file pcb_selection_tool.cpp.

References ExitGroup(), EDA_ITEM::GetParent(), highlight(), KIGFX::VIEW_ITEM::IsBOARD_ITEM(), EDA_ITEM::IsSelected(), m_enteredGroup, m_isFootprintEditor, m_selection, PCB_PAD_T, SELECTED, EDA_ITEM::Type(), and PCB_GROUP::WithinScope().

Referenced by PCB_CONTROL::AppendBoard(), doSyncSelection(), EnterGroup(), ExitGroup(), filterSelection(), FindItem(), grabUnconnected(), FOOTPRINT_EDIT_FRAME::installFootprintTabBoard(), DIALOG_UPDATE_PCB::PerformUpdate(), SelectAll(), selectAllConnectedShapes(), selectAllConnectedTracks(), SelectAllItemsOnNet(), selectAllItemsOnSheet(), selectCellsBetween(), SelectColumns(), selectConnections(), SelectMultiple(), selectNet(), selectPoint(), SelectRows(), SelectTable(), selectUnconnected(), toggleTableCellSelection(), unrouteSegment(), and unrouteSelected().

◆ Selectable()

bool PCB_SELECTION_TOOL::Selectable	(	const BOARD_ITEM *	aItem,
		bool	checkVisibilityOnly = false ) const

Returns: true if an item fulfills conditions to be selected.

Definition at line 3796 of file pcb_selection_tool.cpp.

References LSET::AllLayersMask(), EDA_GROUP::AsEdaItem(), board(), frame(), PCB_TABLECELL::GetColSpan(), PCB_BASE_FRAME::GetDisplayOptions(), KIGFX::RENDER_SETTINGS::GetHighContrast(), KIGFX::RENDER_SETTINGS::GetHighContrastLayers(), BOARD_ITEM::GetLayer(), ZONE::GetLayerSet(), KIGFX::VIEW::GetPainter(), BOARD_ITEM::GetParentFootprint(), EDA_ITEM::GetParentGroup(), PCB_TABLECELL::GetRowSpan(), KIGFX::PAINTER::GetSettings(), TOOL_BASE::getView(), BOARD::GetVisibleLayers(), FOOTPRINT::GraphicalItems(), group, EDA_SHAPE::IsAnyFill(), MARKER_BASE::IsExcluded(), BOARD::IsLayerVisible(), KIGFX::VIEW::IsLayerVisible(), PCB_FIELD::IsReference(), ZONE::IsTeardropArea(), PCB_FIELD::IsValue(), EDA_TEXT::IsVisible(), KI_FALLTHROUGH, LAYER_DRAW_BITMAPS, LAYER_DRC_EXCLUSION, LAYER_FP_REFERENCES, LAYER_FP_TEXT, LAYER_FP_VALUES, LAYER_POINTS, LAYER_TRACKS, LAYER_VIAS, LAYER_ZONES, PCB_DISPLAY_OPTIONS::m_FilledShapeOpacity, PCB_DISPLAY_OPTIONS::m_ImageOpacity, m_isFootprintEditor, PCB_DISPLAY_OPTIONS::m_PadOpacity, PCB_DISPLAY_OPTIONS::m_TrackOpacity, PCB_DISPLAY_OPTIONS::m_ViaOpacity, PCB_DISPLAY_OPTIONS::m_ZoneOpacity, NOT_USED, NPTH, pad, FOOTPRINT::Pads(), PCB_ARC_T, PCB_BARCODE_T, PCB_DIM_ALIGNED_T, PCB_DIM_CENTER_T, PCB_DIM_LEADER_T, PCB_DIM_ORTHOGONAL_T, PCB_DIM_RADIAL_T, PCB_FIELD_T, PCB_FOOTPRINT_T, PCB_GENERATOR_T, PCB_GROUP_T, PCB_MARKER_T, PCB_NETINFO_T, PCB_PAD_T, PCB_POINT_T, PCB_REFERENCE_IMAGE_T, PCB_SHAPE_T, PCB_TABLE_T, PCB_TABLECELL_T, PCB_TEXT_T, PCB_TEXTBOX_T, PCB_TRACE_T, PCB_VIA_T, PCB_ZONE_T, LSET::PhysicalLayersMask(), FOOTPRINT::Points(), PTH, Selectable(), BASE_SET::set(), text, ToLAYER_ID(), EDA_ITEM::Type(), TYPE_NOT_INIT, via, view(), and FOOTPRINT::Zones().

Referenced by PCB_CONTROL::InteractiveDelete(), BOARD_INSPECTION_TOOL::pickItemForInspection(), Selectable(), SelectAll(), SelectMultiple(), selectPoint(), and UnselectAll().

◆ SelectAll()

int PCB_SELECTION_TOOL::SelectAll ( const TOOL_EVENT & aEvent )

Unselect all items on the board.

Definition at line 1741 of file pcb_selection_tool.cpp.

References COLLECTOR::Append(), FilterCollectorForHierarchy(), TOOL_BASE::getView(), KIGFX::VIEW_ITEM::IsBOARD_ITEM(), itemPassesFilter(), m_frame, TOOL_BASE::m_toolMgr, KIGFX::VIEW::Query(), select(), Selectable(), EVENTS::SelectedEvent, and BOX2< Vec >::SetMaximum().

Referenced by setTransitions().

◆ selectAllConnectedShapes()

void PCB_SELECTION_TOOL::selectAllConnectedShapes ( const std::vector< PCB_SHAPE * > & aStartItems )

private

Select all non-closed shapes that are graphically connected to the given start items.

Parameters

aStartItems is a list of one or more non-closed shapes

Definition at line 2629 of file pcb_selection_tool.cpp.

References board(), GENERAL_COLLECTOR::Collect(), getCollectorsGuide(), EDA_SHAPE::GetEnd(), PCB_SHAPE::GetLayerSet(), EDA_SHAPE::GetStart(), EDA_ITEM::HasFlag(), isExpandableGraphicShape(), itemPassesFilter(), PCB_SHAPE_T, select(), EDA_ITEM::SetFlags(), GENERAL_COLLECTORS_GUIDE::SetLayerVisibleBits(), and SKIP_STRUCT.

Referenced by expandConnection().

◆ selectAllConnectedTracks()

void PCB_SELECTION_TOOL::selectAllConnectedTracks	(	const std::vector< BOARD_CONNECTED_ITEM * > &	aStartItems,
		STOP_CONDITION	aStopCondition )

private

Select connected tracks and vias.

Parameters

aStopCondition Indicates where to stop selecting more items.

Definition at line 2221 of file pcb_selection_tool.cpp.

References LSET::AllCuMask(), EDA_GROUP::AsEdaItem(), board(), LSET::Contains(), LSET::CuStack(), EXCLUDE_ZONES, PCB_SHAPE::GetConnectionPoints(), BOARD::GetConnectivity(), PCB_TRACK::GetEnd(), PCB_TRACK::GetLayerSet(), PCB_VIA::GetLayerSet(), EDA_ITEM::GetParentGroup(), PCB_VIA::GetPosition(), PCB_TRACK::GetStart(), PCB_VIA::GetWidth(), EDA_ITEM::HasFlag(), IGNORE_NETS, EDA_ITEM::IsSelected(), itemPassesFilter(), m_frame, m_selection, PROF_TIMER::msecs(), pad, PCB_ARC_T, PCB_GENERATOR_T, PCB_PAD_T, PCB_SHAPE_T, PCB_TRACE_T, PCB_VIA_T, radius, select(), EDA_ITEM::SetFlags(), SKIP_STRUCT, PROF_TIMER::Start(), STOP_AT_JUNCTION, STOP_AT_PAD, STOP_AT_SEGMENT, EDA_ITEM::Type(), unselect(), and via.

Referenced by expandConnection(), selectConnections(), unrouteSegment(), and unrouteSelected().

◆ SelectAllItemsOnNet()

void PCB_SELECTION_TOOL::SelectAllItemsOnNet	(	int	aNetCode,
		bool	aSelect = true )

Select all items with the given net code.

Parameters

aNetCode	is the target net to select
aSelect	is true to add the items to the selection, false to remove them (deselect)

Definition at line 2828 of file pcb_selection_tool.cpp.

References board(), BOARD::GetConnectivity(), itemPassesFilter(), select(), and unselect().

Referenced by BOARD_EDITOR_CONTROL::AssignNetclass(), FindItem(), selectNet(), and selectNetChain().

◆ selectAllItemsOnSheet()

void PCB_SELECTION_TOOL::selectAllItemsOnSheet ( wxString & aSheetPath )

private

Select all items with the given sheet timestamp/UUID name (the sheet path).

The path of the root sheet is "/". Select all footprints belonging to same sheet, from Eeschema using cross-probing.

Definition at line 2931 of file pcb_selection_tool.cpp.

References board(), select(), and selectConnections().

Referenced by selectSameSheet(), and selectSheetContents().

◆ selectCellsBetween()

void PCB_SELECTION_TOOL::selectCellsBetween	(	const VECTOR2D &	aStart,
		const VECTOR2D &	aEnd,
		PCB_TABLE *	aTable )

private

Select table cells contained within the rectangle defined by two corner points, combining the result with the prior selection state (recorded by initializeTableCellSelectionState) according to the current modifier keys.

Definition at line 1090 of file pcb_selection_tool.cpp.

References CANDIDATE, PCB_TABLE::GetCells(), SELECTION_TOOL::m_additive, SELECTION_TOOL::m_exclusive_or, SELECTION_TOOL::m_subtractive, BOX2< Vec >::Normalize(), select(), and unselect().

Referenced by extendTableCellSelectionTo(), and selectTableCells().

◆ SelectColumns()

int PCB_SELECTION_TOOL::SelectColumns ( const TOOL_EVENT & aEvent )

Definition at line 5069 of file pcb_selection_tool.cpp.

References EDA_ITEM::IsSelected(), m_selection, TOOL_BASE::m_toolMgr, select(), EVENTS::SelectedEvent, and table.

Referenced by setTransitions().

◆ selectConnections()

void PCB_SELECTION_TOOL::selectConnections ( const std::vector< BOARD_ITEM * > & aItems )

private

Definition at line 2960 of file pcb_selection_tool.cpp.

References board(), BOARD::GetConnectivity(), pad, PCB_FOOTPRINT_T, PCB_PAD_T, select(), selectAllConnectedTracks(), and STOP_AT_PAD.

Referenced by doSyncSelection(), and selectAllItemsOnSheet().

◆ selectCursor()

bool PCB_SELECTION_TOOL::selectCursor	(	bool	aForceSelect = false,
		CLIENT_SELECTION_FILTER	aClientFilter = nullptr )

private

Select an item under the cursor unless there is something already selected.

Parameters

aForceSelect	[optional] Forces an item to be selected even if there is already a selection.
aClientFilter	A callback to allow tool- or action-specific filtering.

Returns: whether or not the selection is empty.

Definition at line 1040 of file pcb_selection_tool.cpp.

References ClearSelection(), TOOL_BASE::getViewControls(), m_selection, and selectPoint().

Referenced by CursorSelection(), expandConnection(), selectNet(), and selectNetChain().

◆ selection()

SELECTION & PCB_SELECTION_TOOL::selection ( )

inlineoverrideprotectedvirtual

Return a reference to the selection.

Implements SELECTION_TOOL.

Definition at line 299 of file pcb_selection_tool.h.

References m_selection.

Referenced by filterSelection(), selectNet(), and selectNetChain().

◆ selectionContains()

bool PCB_SELECTION_TOOL::selectionContains ( const VECTOR2I & aPoint ) const

private

Returns: true if the given point is contained in any of selected items' bounding boxes.

Definition at line 4213 of file pcb_selection_tool.cpp.

References BOX2< Vec >::Contains(), TOOL_BASE::getView(), group, EDA_ITEM::HitTest(), BOX2< Vec >::Inflate(), KiROUND(), m_selection, and RECURSE.

Referenced by Main().

◆ SelectionMenu()

int SELECTION_TOOL::SelectionMenu ( const TOOL_EVENT & aEvent )

inherited

Show a popup menu to trim the COLLECTOR passed as aEvent's parameter down to a single item.

Note: This routine does not modify the selection.

Definition at line 243 of file selection_tool.cpp.

References doSelectionMenu(), COLLECTOR::m_MenuCancelled, and TOOL_EVENT::Parameter().

Referenced by PCB_SELECTION_TOOL::setTransitions(), PL_SELECTION_TOOL::setTransitions(), and SCH_SELECTION_TOOL::setTransitions().

◆ SelectMultiple()

void PCB_SELECTION_TOOL::SelectMultiple	(	KIGFX::PREVIEW::SELECTION_AREA &	aArea,
		bool	aSubtractive = false,
		bool	aExclusiveOr = false )

Selects multiple PCB items within a specified area.

Definition at line 1573 of file pcb_selection_tool.cpp.

References COLLECTOR::Append(), COLLECTOR::begin(), board(), KIGEOM::BoxHitTest(), BOX2< Vec >::Contains(), COLLECTOR::end(), FilterCollectedItems(), FilterCollectorForHierarchy(), COLLECTOR::GetCount(), KIGFX::PREVIEW::SELECTION_AREA::GetMode(), KIGFX::PREVIEW::SELECTION_AREA::GetPoly(), TOOL_BASE::getView(), group, INSIDE_LASSO, INSIDE_RECTANGLE, EDA_ITEM::IsSelected(), m_enteredGroup, m_isFootprintEditor, m_selection, TOOL_BASE::m_toolMgr, PCB_PAD_T, select(), Selectable(), EVENTS::SelectedEvent, TOUCHING_RECTANGLE, EDA_ITEM::Type(), unselect(), EVENTS::UnselectedEvent, view(), and KIGFX::PREVIEW::SELECTION_AREA::ViewBBox().

Referenced by SelectPolyArea(), and SelectRectArea().

◆ selectNet()

int PCB_SELECTION_TOOL::selectNet ( const TOOL_EVENT & aEvent )

private

Select all copper connections belonging to the same net(s) as the items in the selection.

Definition at line 2843 of file pcb_selection_tool.cpp.

References BOARD_CONNECTED_ITEM::GetNetCode(), TOOL_EVENT::IsAction(), m_selection, TOOL_BASE::m_toolMgr, TOOL_EVENT::Parameter(), select(), SelectAllItemsOnNet(), selectCursor(), EVENTS::SelectedEvent, selection(), PCB_ACTIONS::selectNet, and EVENTS::UnselectedEvent.

Referenced by setTransitions().

◆ selectNetChain()

int PCB_SELECTION_TOOL::selectNetChain ( const TOOL_EVENT & aEvent )

private

Select all copper connections belonging to every net in the selected item's net chain.

Definition at line 2887 of file pcb_selection_tool.cpp.

References board(), BOARD_CONNECTED_ITEM::GetNet(), NETINFO_ITEM::GetNetChain(), BOARD_CONNECTED_ITEM::GetNetCode(), m_selection, TOOL_BASE::m_toolMgr, SelectAllItemsOnNet(), selectCursor(), EVENTS::SelectedEvent, selection(), and EVENTS::UnselectedEvent.

Referenced by setTransitions().

◆ selectPoint()

bool PCB_SELECTION_TOOL::selectPoint	(	const VECTOR2I &	aWhere,
		bool	aOnDrag = false,
		bool *	aSelectionCancelledFlag = nullptr,
		CLIENT_SELECTION_FILTER	aClientFilter = nullptr )

private

Select an item pointed by the parameter aWhere.

If there is more than one item at that place, there is a menu displayed that allows one to choose the item.

Parameters

aWhere	is the place where the item should be selected.
aOnDrag	indicates whether a drag operation is being performed.
aSelectionCancelledFlag	allows the function to inform its caller that a selection was canceled (for instance, by clicking outside of the disambiguation menu).
aClientFilter	a callback to allow tool- or action-specific filtering.

Returns: whether or not the selection is empty.

Definition at line 895 of file pcb_selection_tool.cpp.

References GENERAL_COLLECTOR::AllBoardItems, board(), BUT_LEFT, ClearSelection(), GENERAL_COLLECTOR::Collect(), SELECTION_TOOL::doSelectionMenu(), editFrame(), ExitGroup(), FilterCollectedItems(), FilterCollectorForFootprints(), FilterCollectorForHierarchy(), GENERAL_COLLECTOR::FootprintItems, getCollectorsGuide(), COLLECTOR::GetCount(), GuessSelectionCandidates(), SELECTION_TOOL::m_additive, m_enteredGroup, SELECTION_TOOL::m_exclusive_or, m_frame, m_isFootprintEditor, m_selection, SELECTION_TOOL::m_skip_heuristics, SELECTION_TOOL::m_subtractive, TOOL_BASE::m_toolMgr, PCB_DISPLAY_OPTIONS::m_ZoneDisplayMode, EVENTS::PointSelectedEvent, COLLECTOR::Remove(), select(), Selectable(), EVENTS::SelectedEvent, PCB_SELECTION_FILTER_OPTIONS::SetAll(), GENERAL_COLLECTORS_GUIDE::SetIgnoreZoneFills(), SHOW_FILLED, TA_MOUSE_UP, TC_ANY, unselect(), EVENTS::UnselectedEvent, and TOOL_INTERACTIVE::Wait().

Referenced by disambiguateCursor(), Main(), and selectCursor().

◆ SelectPolyArea()

int PCB_SELECTION_TOOL::SelectPolyArea ( const TOOL_EVENT & aEvent )

Handles drawing a lasso selection area that allows multiple items to be selected simultaneously.

Returns: true if the operation was canceled (i.e. a CancelEvent was received).

Definition at line 1474 of file pcb_selection_tool.cpp.

Referenced by Main().

◆ SelectRectArea()

int PCB_SELECTION_TOOL::SelectRectArea ( const TOOL_EVENT & aEvent )

Handles drawing a selection box that allows multiple items to be selected simultaneously.

Returns: true if the operation was canceled (i.e. a CancelEvent was received).

Definition at line 1372 of file pcb_selection_tool.cpp.

Referenced by Main().

◆ SelectRows()

int PCB_SELECTION_TOOL::SelectRows ( const TOOL_EVENT & aEvent )

Definition at line 5104 of file pcb_selection_tool.cpp.

References EDA_ITEM::IsSelected(), m_selection, TOOL_BASE::m_toolMgr, select(), EVENTS::SelectedEvent, and table.

Referenced by setTransitions().

◆ selectSameSheet()

int PCB_SELECTION_TOOL::selectSameSheet ( const TOOL_EVENT & aEvent )

private

Set selection to items passed by parameter and connected nets (optionally).

Zooms to fit, if enabled

Definition at line 3133 of file pcb_selection_tool.cpp.

References KIID_PATH::AsString(), ClearSelection(), FOOTPRINT::GetPath(), m_selection, TOOL_BASE::m_toolMgr, PCB_FOOTPRINT_T, selectAllItemsOnSheet(), EVENTS::SelectedEvent, and EDA_ITEM::Type().

Referenced by setTransitions().

◆ selectSheetContents()

int PCB_SELECTION_TOOL::selectSheetContents ( const TOOL_EVENT & aEvent )

private

Select all footprints belonging to same hierarchical sheet as the selected footprint (same sheet path).

Definition at line 3117 of file pcb_selection_tool.cpp.

References ClearSelection(), m_selection, TOOL_BASE::m_toolMgr, TOOL_EVENT::Parameter(), selectAllItemsOnSheet(), EVENTS::SelectedEvent, and zoomFitSelection().

Referenced by setTransitions().

◆ SelectTable()

int PCB_SELECTION_TOOL::SelectTable ( const TOOL_EVENT & aEvent )

Clear current selection event handler.

Definition at line 5139 of file pcb_selection_tool.cpp.

References ClearSelection(), m_selection, TOOL_BASE::m_toolMgr, select(), EVENTS::SelectedEvent, and table.

Referenced by setTransitions().

◆ selectTableCells()

bool PCB_SELECTION_TOOL::selectTableCells ( PCB_TABLE * aTable )

private

Definition at line 1284 of file pcb_selection_tool.cpp.

References allowedActions, BUT_LEFT, CANDIDATE, end, PCB_TABLE::GetCells(), TOOL_BASE::getViewControls(), initializeTableCellSelectionState(), SELECTION_TOOL::m_additive, SELECTION_TOOL::m_multiple, m_previousFirstCell, m_selection, TOOL_BASE::m_toolMgr, passEvent(), selectCellsBetween(), EVENTS::SelectedEvent, KIGFX::VIEW_CONTROLS::SetAutoPan(), EVENTS::UnselectedEvent, and TOOL_INTERACTIVE::Wait().

Referenced by Main().

◆ selectUnconnected()

int PCB_SELECTION_TOOL::selectUnconnected ( const TOOL_EVENT & aEvent )

private

Select nearest unconnected footprints on same net as selected items.

Definition at line 2678 of file pcb_selection_tool.cpp.

References board(), BOARD::GetConnectivity(), m_selection, pad, PCB_FOOTPRINT_T, PCB_PAD_T, select(), and EDA_ITEM::Type().

Referenced by setTransitions().

◆ SetContextMenu()

void TOOL_INTERACTIVE::SetContextMenu	(	ACTION_MENU *	aMenu,
		CONTEXT_MENU_TRIGGER	aTrigger = CMENU_BUTTON )

inherited

Assign a context menu and tells when it should be activated.

Parameters

aMenu	is the menu to be assigned.
aTrigger	determines conditions upon which the context menu is activated.

Definition at line 91 of file tool_interactive.cpp.

References CMENU_OFF, TOOL_BASE::m_toolMgr, and ACTION_MENU::SetTool().

Referenced by SELECTION_TOOL::doSelectionMenu(), and DRAWING_TOOL::DrawVia().

◆ setModifiersState()

void SELECTION_TOOL::setModifiersState	(	bool	aShiftState,
		bool	aCtrlState,
		bool	aAltState )

protectedinherited

Set the configuration of m_additive, m_subtractive, m_exclusive_or, m_skip_heuristics from the state of modifier keys SHIFT, CTRL, ALT and depending on the OS.

Definition at line 45 of file selection_tool.cpp.

References ctrlClickHighlights(), m_additive, m_drag_additive, m_drag_subtractive, m_exclusive_or, m_highlight_modifier, m_skip_heuristics, and m_subtractive.

Referenced by PCB_SELECTION_TOOL::disambiguateCursor(), PL_SELECTION_TOOL::disambiguateCursor(), SCH_SELECTION_TOOL::disambiguateCursor(), GERBVIEW_SELECTION_TOOL::Main(), PCB_SELECTION_TOOL::Main(), PL_SELECTION_TOOL::Main(), SCH_SELECTION_TOOL::Main(), PCB_SELECTION_TOOL::OnIdle(), and SCH_SELECTION_TOOL::OnIdle().

◆ SetSelectPoly()

int PCB_SELECTION_TOOL::SetSelectPoly ( const TOOL_EVENT & aEvent )

Definition at line 1456 of file pcb_selection_tool.cpp.

References INSIDE_LASSO, m_frame, m_selectionMode, TOOL_BASE::m_toolMgr, SELECT_LASSO, and ACTIONS::selectionTool.

Referenced by setTransitions().

◆ SetSelectRect()

int PCB_SELECTION_TOOL::SetSelectRect ( const TOOL_EVENT & aEvent )

Definition at line 1465 of file pcb_selection_tool.cpp.

References ARROW, INSIDE_RECTANGLE, m_frame, m_selectionMode, TOOL_BASE::m_toolMgr, and ACTIONS::selectionTool.

Referenced by setTransitions().

◆ setTransitions()

void PCB_SELECTION_TOOL::setTransitions ( )

overridevirtual

Zoom the screen to center and fit the current selection.

Implements TOOL_INTERACTIVE.

Definition at line 5168 of file pcb_selection_tool.cpp.

References SELECTION_TOOL::AddItemsToSel(), SELECTION_TOOL::AddItemToSel(), ClearSelection(), CursorSelection(), PCB_ACTIONS::deselectNet, disambiguateCursor(), EVENTS::DisambiguatePoint, expandConnection(), PCB_ACTIONS::filterSelection, filterSelection(), TOOL_INTERACTIVE::Go(), PCB_ACTIONS::grabUnconnected, grabUnconnected(), Main(), SELECTION_TOOL::RemoveItemFromSel(), SELECTION_TOOL::RemoveItemsFromSel(), SELECTION_TOOL::ReselectItem(), ACTIONS::reselectItem, SelectAll(), ACTIONS::selectAll, SelectColumns(), ACTIONS::selectColumns, PCB_ACTIONS::selectConnection, EVENTS::SelectedItemsModified, EVENTS::SelectedItemsMoved, ACTIONS::selectionActivate, ACTIONS::selectionClear, ACTIONS::selectionCursor, SELECTION_TOOL::SelectionMenu(), ACTIONS::selectionMenu, ACTIONS::selectItem, ACTIONS::selectItems, PCB_ACTIONS::selectNet, selectNet(), PCB_ACTIONS::selectNetChain, selectNetChain(), PCB_ACTIONS::selectOnSheetFromEeschema, SelectRows(), ACTIONS::selectRows, PCB_ACTIONS::selectSameSheet, selectSameSheet(), ACTIONS::selectSetLasso, ACTIONS::selectSetRect, selectSheetContents(), SelectTable(), ACTIONS::selectTable, PCB_ACTIONS::selectUnconnected, selectUnconnected(), SetSelectPoly(), SetSelectRect(), PCB_ACTIONS::syncSelection, syncSelection(), PCB_ACTIONS::syncSelectionWithNets, syncSelectionWithNets(), PCB_ACTIONS::unrouteSegment, unrouteSegment(), PCB_ACTIONS::unrouteSelected, unrouteSelected(), UnselectAll(), ACTIONS::unselectAll, ACTIONS::unselectItem, ACTIONS::unselectItems, SELECTION_TOOL::UpdateMenu(), ACTIONS::updateMenu, and updateSelection().

◆ singleSelectedCell()

PCB_TABLECELL * PCB_SELECTION_TOOL::singleSelectedCell ( ) const

private

Returns: the single PCB_TABLECELL in the current selection, or nullptr if the selection is empty, has more than one item, or holds something else.

Definition at line 1224 of file pcb_selection_tool.cpp.

References m_selection.

Referenced by Main().

◆ syncSelection()

int PCB_SELECTION_TOOL::syncSelection ( const TOOL_EVENT & aEvent )

private

Definition at line 3051 of file pcb_selection_tool.cpp.

References doSyncSelection(), and TOOL_EVENT::Parameter().

Referenced by setTransitions().

◆ syncSelectionWithNets()

int PCB_SELECTION_TOOL::syncSelectionWithNets ( const TOOL_EVENT & aEvent )

private

Definition at line 3062 of file pcb_selection_tool.cpp.

References doSyncSelection(), and TOOL_EVENT::Parameter().

Referenced by setTransitions().

◆ toggleTableCellSelection()

bool PCB_SELECTION_TOOL::toggleTableCellSelection ( const VECTOR2I & aPosition )

private

When the user Ctrl-clicks inside a PCB_TABLE whose cells are already in the selection, toggle that cell into or out of the selection instead of triggering the net-highlight action.

Matches eeschema's table behaviour and mirrors eeschema 10.0.1, where Ctrl- (then Shift-) click could be used to build a discontinuous cell selection.

Returns: true if a toggle was performed; false if the caller should fall back to the usual Ctrl-click action (net highlight).

Definition at line 1233 of file pcb_selection_tool.cpp.

References collectTableCellsAt(), COLLECTOR::GetCount(), BOARD_ITEM::GetParent(), EDA_ITEM::IsSelected(), m_previousFirstCell, m_selection, TOOL_BASE::m_toolMgr, EVENTS::PointSelectedEvent, select(), unselect(), and EVENTS::UnselectedEvent.

Referenced by Main().

◆ UnbrightenItem()

void SELECTION_TOOL::UnbrightenItem ( EDA_ITEM * aItem )

inherited

Definition at line 222 of file selection_tool.cpp.

References BRIGHTENED, and unhighlight().

Referenced by SCH_EDIT_FRAME::DisplayCurrentSheet(), SCH_DRAWING_TOOLS::doSyncSheetsPins(), BOARD_INSPECTION_TOOL::InspectClearance(), PCB_CONTROL::InteractiveDelete(), PL_EDIT_TOOL::InteractiveDelete(), SCH_TOOL_BASE< T >::InteractiveDelete(), PANEL_COMPONENT_CLASS_ASSIGNMENT::OnHighlightItemsClick(), BOARD_INSPECTION_TOOL::pickItemForInspection(), SCH_EDITOR_CONTROL::SimProbe(), SCH_EDITOR_CONTROL::SimTune(), and PANEL_ASSIGN_COMPONENT_CLASSES::~PANEL_ASSIGN_COMPONENT_CLASSES().

◆ unhighlight()

void PCB_SELECTION_TOOL::unhighlight	(	EDA_ITEM *	aItem,
		int	aHighlightMode,
		SELECTION *	aGroup = nullptr )

overrideprivatevirtual

Unhighlight the item visually.

Parameters

aItem	The item to be highlighted.
aHighlightMode	Either SELECTED or BRIGHTENED
aGroup	[optional] A group to remove the item from.

Implements SELECTION_TOOL.

Definition at line 4177 of file pcb_selection_tool.cpp.

References BRIGHTENED, TOOL_BASE::getView(), KIGFX::VIEW::MarkTargetDirty(), SELECTION::Remove(), KIGFX::REPAINT, KIGFX::TARGET_OVERLAY, unhighlightInternal(), KIGFX::PCB_VIEW::Update(), and view().

Referenced by ClearSelection(), RequestSelection(), and unselect().

◆ unhighlightInternal()

void PCB_SELECTION_TOOL::unhighlightInternal	(	EDA_ITEM *	aItem,
		int	aHighlightMode,
		bool	aUsingOverlay )

private

Definition at line 4191 of file pcb_selection_tool.cpp.

References BRIGHTENED, EDA_ITEM::ClearBrightened(), EDA_ITEM::ClearSelected(), KIGFX::VIEW::Hide(), KIGFX::VIEW_ITEM::IsBOARD_ITEM(), RECURSE, BOARD_ITEM::RunOnChildren(), SELECTED, unhighlightInternal(), KIGFX::PCB_VIEW::Update(), and view().

Referenced by unhighlight(), and unhighlightInternal().

◆ unrouteSegment()

int PCB_SELECTION_TOOL::unrouteSegment ( const TOOL_EVENT & aEvent )

private

Unroute the selected track connected item.

Definition at line 2025 of file pcb_selection_tool.cpp.

References _, EDA_GROUP::AsEdaItem(), BOARD_CONNECTED_ITEM::ClassOf(), ClearSelection(), PCB_GROUP::GetBoardItems(), EDA_ITEM::GetParentGroup(), m_selection, TOOL_BASE::m_toolMgr, PCB_ARC_T, PCB_GENERATOR_T, PCB_TRACE_T, PCB_VIA_T, BOARD_COMMIT::Push(), RECURSE, COMMIT::Remove(), BOARD_ITEM::RunOnChildren(), select(), selectAllConnectedTracks(), STOP_AT_SEGMENT, and EDA_ITEM::Type().

Referenced by setTransitions().

◆ unrouteSelected()

int PCB_SELECTION_TOOL::unrouteSelected ( const TOOL_EVENT & aEvent )

private

Unroute the selected board connected items.

Definition at line 1823 of file pcb_selection_tool.cpp.

References _, board(), BOARD_CONNECTED_ITEM::ClassOf(), ClearSelection(), PCB_TRACK::GetEnd(), BOARD_CONNECTED_ITEM::GetNetCode(), PCB_TRACK::GetStart(), m_filter, m_selection, TOOL_BASE::m_toolMgr, pad, PCB_FOOTPRINT_T, PCB_GENERATOR_T, PCB_PAD_T, PCB_VIA_T, BOARD_COMMIT::Push(), RECURSE, COMMIT::Remove(), BOARD_ITEM::RunOnChildren(), select(), selectAllConnectedTracks(), STOP_AT_PAD, and EDA_ITEM::Type().

Referenced by setTransitions().

◆ unselect()

void PCB_SELECTION_TOOL::unselect ( EDA_ITEM * aItem )

overrideprivatevirtual

Take necessary action mark an item as unselected.

Parameters

aItem is an item to be unselected.

Implements SELECTION_TOOL.

Definition at line 4137 of file pcb_selection_tool.cpp.

References m_selection, SELECTED, and unhighlight().

Referenced by extendTableCellSelectionTo(), selectAllConnectedTracks(), SelectAllItemsOnNet(), selectCellsBetween(), SelectMultiple(), selectPoint(), toggleTableCellSelection(), and UnselectAll().

◆ UnselectAll()

int PCB_SELECTION_TOOL::UnselectAll ( const TOOL_EVENT & aEvent )

Change the selection mode.

Definition at line 1775 of file pcb_selection_tool.cpp.

References TOOL_BASE::getView(), KIGFX::VIEW_ITEM::IsBOARD_ITEM(), m_frame, TOOL_BASE::m_toolMgr, KIGFX::VIEW::Query(), Selectable(), BOX2< Vec >::SetMaximum(), unselect(), and EVENTS::UnselectedEvent.

Referenced by setTransitions().

◆ UpdateMenu()

int SELECTION_TOOL::UpdateMenu ( const TOOL_EVENT & aEvent )

inherited

Update a menu's state based on the current selection.

The menu is passed in aEvent's parameter.

Definition at line 89 of file selection_tool.cpp.

References CONDITIONAL_MENU::Evaluate(), TOOL_EVENT::Parameter(), selection(), and ACTION_MENU::UpdateAll().

Referenced by GERBVIEW_SELECTION_TOOL::setTransitions(), PCB_SELECTION_TOOL::setTransitions(), PL_SELECTION_TOOL::setTransitions(), and SCH_SELECTION_TOOL::setTransitions().

◆ updateSelection()

int PCB_SELECTION_TOOL::updateSelection ( const TOOL_EVENT & aEvent )

private

Event handler to update the selection VIEW_ITEM.

Definition at line 5060 of file pcb_selection_tool.cpp.

References TOOL_BASE::getView(), m_enteredGroupOverlay, m_selection, and KIGFX::VIEW::Update().

Referenced by setTransitions().

◆ view()

KIGFX::PCB_VIEW * PCB_SELECTION_TOOL::view ( ) const

inlineprotected

Definition at line 267 of file pcb_selection_tool.h.

References TOOL_BASE::getView().

Referenced by ClearSelection(), doSyncSelection(), EnterGroup(), ExitGroup(), FilterCollectorForFootprints(), getCollectorsGuide(), highlight(), highlightInternal(), Reset(), Selectable(), SelectMultiple(), SelectRectArea(), unhighlight(), unhighlightInternal(), ZoomFitCrossProbeBBox(), and zoomFitSelection().

◆ Wait()

TOOL_EVENT * TOOL_INTERACTIVE::Wait ( const TOOL_EVENT_LIST & aEventList = TOOL_EVENT( TC_ANY, TA_ANY ) )

inherited

Suspend execution of the tool until an event specified in aEventList arrives.

No parameters means waiting for any event.

Definition at line 67 of file tool_interactive.cpp.

References TOOL_BASE::m_toolMgr.

Referenced by PCB_TOOL_BASE::doInteractiveItemPlacement(), EDIT_TOOL::doMoveSelection(), SELECTION_TOOL::doSelectionMenu(), DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawBarcode(), DRAWING_TOOL::DrawDimension(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::drawOneBezier(), PL_DRAWING_TOOLS::DrawShape(), DRAWING_TOOL::drawShape(), DRAWING_TOOL::DrawTable(), DRAWING_TOOL::DrawVia(), DRAWING_TOOL::DrawZone(), PAD_TOOL::EnumeratePads(), ROUTER_TOOL::InlineDrag(), POSITION_RELATIVE_TOOL::InteractiveOffset(), CVPCB_CONTROL::Main(), CVPCB_FOOTPRINT_VIEWER_SELECTION_TOOL::Main(), EDA_3D_CONTROLLER::Main(), GERBVIEW_SELECTION_TOOL::Main(), PCB_PICKER_TOOL::Main(), PCB_SELECTION_TOOL::Main(), PCB_TEST_SELECTION_TOOL::Main(), PICKER_TOOL::Main(), PL_EDIT_TOOL::Main(), PL_POINT_EDITOR::Main(), PL_SELECTION_TOOL::Main(), SCH_SELECTION_TOOL::Main(), ZOOM_TOOL::Main(), ROUTER_TOOL::MainLoop(), GERBVIEW_INSPECTION_TOOL::MeasureTool(), PCB_VIEWER_TOOLS::MeasureTool(), PCB_POINT_EDITOR::OnSelectionChange(), ROUTER_TOOL::performDragging(), ROUTER_TOOL::performRouting(), BOARD_INSPECTION_TOOL::pickItemForInspection(), PCB_GROUP_TOOL::PickNewMember(), SCH_GROUP_TOOL::PickNewMember(), EDIT_TOOL::pickReferencePoint(), BOARD_EDITOR_CONTROL::PlaceFootprint(), DRAWING_TOOL::PlaceImportedGraphics(), PL_DRAWING_TOOLS::PlaceItem(), DRAWING_TOOL::PlaceReferenceImage(), DRAWING_TOOL::PlaceText(), DRAWING_TOOL::PlaceTuningPattern(), SCH_SELECTION_TOOL::selectLasso(), PL_SELECTION_TOOL::selectMultiple(), SCH_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::SelectPolyArea(), PCB_SELECTION_TOOL::SelectRectArea(), ZOOM_TOOL::selectRegion(), PCB_SELECTION_TOOL::selectTableCells(), SCH_SELECTION_TOOL::selectTableCells(), DRAWING_TOOL::SetAnchor(), and DIFF_PHASE_SKEW_TOOL::ShowDiffPhaseSkew().

◆ ZoomFitCrossProbeBBox()

void PCB_SELECTION_TOOL::ZoomFitCrossProbeBBox ( const BOX2I & bbox )

Definition at line 3192 of file pcb_selection_tool.cpp.

References DEFAULT_TEXT_SIZE, BOX2< Vec >::GetSize(), TOOL_BASE::getView(), BOX2< Vec >::GetWidth(), BOX2< Vec >::Inflate(), KiROUND(), m_frame, next(), BOX2< Vec >::Normalize(), pcbIUScale, ToVECTOR2D(), view(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by doSyncSelection().

◆ zoomFitSelection()

void PCB_SELECTION_TOOL::zoomFitSelection ( )

Zoom the screen to fit the bounding box for cross probing/selection sync.

Definition at line 3167 of file pcb_selection_tool.cpp.

References BOX2< Vec >::Centre(), BOX2< Vec >::GetHeight(), BOX2< Vec >::GetSize(), TOOL_BASE::getView(), BOX2< Vec >::GetWidth(), m_frame, m_selection, scale, ToVECTOR2D(), view(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by selectSheetContents().

Member Data Documentation

◆ m_additive

bool SELECTION_TOOL::m_additive

protectedinherited

Items should be added to sel (instead of replacing).

Definition at line 146 of file selection_tool.h.

Referenced by SCH_SELECTION_TOOL::disambiguateCursor(), PCB_SELECTION_TOOL::extendTableCellSelectionTo(), PCB_SELECTION_TOOL::FilterCollectorForFootprints(), hasModifier(), PL_SELECTION_TOOL::Main(), SCH_SELECTION_TOOL::Main(), PCB_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::SelectCellsBetween(), PCB_SELECTION_TOOL::selectCellsBetween(), SELECTION_TOOL(), PL_SELECTION_TOOL::SelectPoint(), GERBVIEW_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::SelectPolyArea(), PCB_SELECTION_TOOL::selectTableCells(), and setModifiersState().

◆ m_canceledMenu

bool SELECTION_TOOL::m_canceledMenu

protectedinherited

Sets to true if the disambiguation menu was canceled.

Definition at line 158 of file selection_tool.h.

Referenced by PCB_SELECTION_TOOL::disambiguateCursor(), PL_SELECTION_TOOL::disambiguateCursor(), SCH_SELECTION_TOOL::disambiguateCursor(), PCB_SELECTION_TOOL::Main(), and SELECTION_TOOL().

◆ m_disambiguateTimer

wxTimer SELECTION_TOOL::m_disambiguateTimer

protectedinherited

Timer to show the disambiguate menu.

Definition at line 160 of file selection_tool.h.

Referenced by PCB_SELECTION_TOOL::Init(), PL_SELECTION_TOOL::Init(), SCH_SELECTION_TOOL::Init(), PCB_SELECTION_TOOL::Main(), PCB_TEST_SELECTION_TOOL::Main(), PL_SELECTION_TOOL::Main(), and SCH_SELECTION_TOOL::Main().

◆ m_drag_additive

bool SELECTION_TOOL::m_drag_additive

protectedinherited

Add multiple items to selection.

Definition at line 155 of file selection_tool.h.

Referenced by SELECTION_TOOL(), SCH_SELECTION_TOOL::selectLasso(), PL_SELECTION_TOOL::selectMultiple(), SCH_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::SelectPolyArea(), PCB_SELECTION_TOOL::SelectRectArea(), and setModifiersState().

◆ m_drag_subtractive

bool SELECTION_TOOL::m_drag_subtractive

protectedinherited

Remove multiple from selection.

Definition at line 156 of file selection_tool.h.

Referenced by SELECTION_TOOL(), SCH_SELECTION_TOOL::selectLasso(), PL_SELECTION_TOOL::selectMultiple(), SCH_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::SelectPolyArea(), PCB_SELECTION_TOOL::SelectRectArea(), and setModifiersState().

◆ m_enteredGroup

PCB_GROUP* PCB_SELECTION_TOOL::m_enteredGroup

private

Definition at line 547 of file pcb_selection_tool.h.

Referenced by EnterGroup(), ExitGroup(), FilterCollectorForHierarchy(), GetEnteredGroup(), Init(), Main(), PCB_SELECTION_TOOL(), RebuildSelection(), Reset(), select(), SelectMultiple(), and selectPoint().

◆ m_enteredGroupOverlay

KIGFX::VIEW_GROUP PCB_SELECTION_TOOL::m_enteredGroupOverlay

private

Definition at line 549 of file pcb_selection_tool.h.

Referenced by EnterGroup(), ExitGroup(), RebuildSelection(), Reset(), updateSelection(), and ~PCB_SELECTION_TOOL().

◆ m_exclusive_or

bool SELECTION_TOOL::m_exclusive_or

protectedinherited

Items' selection state should be toggled.

Definition at line 148 of file selection_tool.h.

Referenced by SCH_SELECTION_TOOL::disambiguateCursor(), PCB_SELECTION_TOOL::FilterCollectorForFootprints(), hasModifier(), PL_SELECTION_TOOL::Main(), SCH_SELECTION_TOOL::Main(), PCB_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::SelectCellsBetween(), PCB_SELECTION_TOOL::selectCellsBetween(), SELECTION_TOOL(), PL_SELECTION_TOOL::selectMultiple(), PL_SELECTION_TOOL::SelectPoint(), GERBVIEW_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::SelectPolyArea(), PCB_SELECTION_TOOL::SelectRectArea(), and setModifiersState().

◆ m_filter

PCB_SELECTION_FILTER_OPTIONS PCB_SELECTION_TOOL::m_filter

private

Definition at line 543 of file pcb_selection_tool.h.

Referenced by GetFilter(), itemPassesFilter(), PCB_SELECTION_TOOL(), and unrouteSelected().

◆ m_frame

PCB_BASE_FRAME* PCB_SELECTION_TOOL::m_frame

private

◆ m_highlight_modifier

bool SELECTION_TOOL::m_highlight_modifier

protectedinherited

Select highlight net on left click.

Definition at line 154 of file selection_tool.h.

Referenced by PCB_SELECTION_TOOL::Main(), SELECTION_TOOL(), and setModifiersState().

◆ m_isFootprintEditor

bool PCB_SELECTION_TOOL::m_isFootprintEditor

private

Definition at line 539 of file pcb_selection_tool.h.

Referenced by collectTableCellsAt(), ctrlClickHighlights(), FilterCollectorForFootprints(), FilterCollectorForFreePads(), FilterCollectorForHierarchy(), IsFootprintEditor(), itemPassesFilter(), PCB_SELECTION_TOOL(), RebuildSelection(), Reset(), select(), Selectable(), SelectMultiple(), and selectPoint().

◆ m_lockedItemsFiltered

bool PCB_SELECTION_TOOL::m_lockedItemsFiltered

private

Definition at line 553 of file pcb_selection_tool.h.

Referenced by FilterCollectorForLockedItems(), PCB_SELECTION_TOOL(), ReportFilteredLockedItems(), and RequestSelection().

◆ m_menu

std::unique_ptr<TOOL_MENU> TOOL_INTERACTIVE::m_menu

protectedinherited

The functions below are not yet implemented - their interface may change.

Definition at line 121 of file tool_interactive.h.

Referenced by PCB_TOOL_BASE::doInteractiveItemPlacement(), DRAWING_TOOL::drawArc(), DRAWING_TOOL::DrawBarcode(), DRAWING_TOOL::DrawDimension(), MICROWAVE_TOOL::drawMicrowaveInductor(), DRAWING_TOOL::drawOneBezier(), PL_DRAWING_TOOLS::DrawShape(), DRAWING_TOOL::drawShape(), DRAWING_TOOL::DrawTable(), DRAWING_TOOL::DrawZone(), PAD_TOOL::EnumeratePads(), GetToolMenu(), BOARD_EDITOR_CONTROL::Init(), CVPCB_FOOTPRINT_VIEWER_SELECTION_TOOL::Init(), DRAWING_TOOL::Init(), EDA_3D_CONTROLLER::Init(), FOOTPRINT_EDITOR_CONTROL::Init(), GERBVIEW_SELECTION_TOOL::Init(), PAD_TOOL::Init(), PCB_DESIGN_BLOCK_CONTROL::Init(), PCB_PICKER_TOOL::Init(), PCB_SELECTION_TOOL::Init(), PCB_TOOL_BASE::Init(), PCB_VIEWER_TOOLS::Init(), PICKER_TOOL::Init(), PL_DRAWING_TOOLS::Init(), PL_EDIT_TOOL::Init(), PL_SELECTION_TOOL::Init(), ROUTER_TOOL::Init(), SCH_DESIGN_BLOCK_CONTROL::Init(), SCH_SELECTION_TOOL::Init(), SCH_TOOL_BASE< T >::Init(), ZOOM_TOOL::Init(), CVPCB_FOOTPRINT_VIEWER_SELECTION_TOOL::Main(), EDA_3D_CONTROLLER::Main(), GERBVIEW_SELECTION_TOOL::Main(), PCB_PICKER_TOOL::Main(), PCB_SELECTION_TOOL::Main(), PICKER_TOOL::Main(), PL_EDIT_TOOL::Main(), PL_SELECTION_TOOL::Main(), SCH_SELECTION_TOOL::Main(), ZOOM_TOOL::Main(), ROUTER_TOOL::MainLoop(), GERBVIEW_INSPECTION_TOOL::MeasureTool(), PCB_VIEWER_TOOLS::MeasureTool(), ROUTER_TOOL::performDragging(), ROUTER_TOOL::performRouting(), BOARD_EDITOR_CONTROL::PlaceFootprint(), DRAWING_TOOL::PlaceImportedGraphics(), PL_DRAWING_TOOLS::PlaceItem(), DRAWING_TOOL::PlaceReferenceImage(), DRAWING_TOOL::PlaceText(), DRAWING_TOOL::PlaceTuningPattern(), DRAWING_TOOL::SetAnchor(), TOOL_INTERACTIVE(), and TOOL_INTERACTIVE().

◆ m_multiple

bool SELECTION_TOOL::m_multiple

protectedinherited

Multiple selection mode is active.

Definition at line 149 of file selection_tool.h.

Referenced by PCB_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::SelectAll(), SELECTION_TOOL(), SCH_SELECTION_TOOL::selectLasso(), PL_SELECTION_TOOL::selectMultiple(), SCH_SELECTION_TOOL::selectMultiple(), PCB_SELECTION_TOOL::SelectRectArea(), PCB_SELECTION_TOOL::selectTableCells(), SCH_SELECTION_TOOL::selectTableCells(), and SCH_SELECTION_TOOL::UnselectAll().

◆ m_nonModifiedCursor

KICURSOR PCB_SELECTION_TOOL::m_nonModifiedCursor

private

Definition at line 545 of file pcb_selection_tool.h.

Referenced by Main(), OnIdle(), and PCB_SELECTION_TOOL().

◆ m_originalCursor

VECTOR2I SELECTION_TOOL::m_originalCursor

protectedinherited

Location of original cursor when starting click.

Definition at line 162 of file selection_tool.h.

Referenced by PCB_SELECTION_TOOL::disambiguateCursor(), PL_SELECTION_TOOL::disambiguateCursor(), SCH_SELECTION_TOOL::disambiguateCursor(), PCB_SELECTION_TOOL::Main(), PL_SELECTION_TOOL::Main(), and SCH_SELECTION_TOOL::Main().

◆ m_previousFirstCell

PCB_TABLECELL* PCB_SELECTION_TOOL::m_previousFirstCell

private

Definition at line 556 of file pcb_selection_tool.h.

Referenced by ClearSelection(), extendTableCellSelectionTo(), Main(), PCB_SELECTION_TOOL(), RebuildSelection(), selectTableCells(), and toggleTableCellSelection().

◆ m_priv

std::unique_ptr<PRIV> PCB_SELECTION_TOOL::m_priv

private

Definition at line 560 of file pcb_selection_tool.h.

Referenced by filterSelection(), and PCB_SELECTION_TOOL().

◆ m_selection

PCB_SELECTION PCB_SELECTION_TOOL::m_selection

private

◆ m_selectionMode

SELECTION_MODE PCB_SELECTION_TOOL::m_selectionMode

private

Definition at line 551 of file pcb_selection_tool.h.

Referenced by Main(), PCB_SELECTION_TOOL(), SetSelectPoly(), and SetSelectRect().

◆ m_skip_heuristics

bool SELECTION_TOOL::m_skip_heuristics

protectedinherited

Show disambiguation menu for all items under the cursor rather than trying to narrow them down first using heuristics.

Definition at line 153 of file selection_tool.h.

Referenced by PCB_SELECTION_TOOL::disambiguateCursor(), PL_SELECTION_TOOL::disambiguateCursor(), SCH_SELECTION_TOOL::disambiguateCursor(), SCH_SELECTION_TOOL::narrowSelection(), SELECTION_TOOL(), PL_SELECTION_TOOL::SelectPoint(), PCB_SELECTION_TOOL::selectPoint(), and setModifiersState().

◆ m_subtractive

bool SELECTION_TOOL::m_subtractive

protectedinherited

Items should be removed from selection.

Definition at line 147 of file selection_tool.h.

Referenced by SCH_SELECTION_TOOL::disambiguateCursor(), PCB_SELECTION_TOOL::FilterCollectorForFootprints(), hasModifier(), PL_SELECTION_TOOL::Main(), SCH_SELECTION_TOOL::Main(), PCB_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::OnIdle(), SCH_SELECTION_TOOL::SelectCellsBetween(), PCB_SELECTION_TOOL::selectCellsBetween(), SELECTION_TOOL(), PL_SELECTION_TOOL::selectMultiple(), PL_SELECTION_TOOL::SelectPoint(), GERBVIEW_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::selectPoint(), PCB_SELECTION_TOOL::SelectPolyArea(), PCB_SELECTION_TOOL::SelectRectArea(), and setModifiersState().

◆ m_toolId

TOOL_ID TOOL_BASE::m_toolId

protectedinherited

Unique id, assigned by a TOOL_MANAGER instance.

Definition at line 215 of file tool_base.h.

Referenced by TOOL_INTERACTIVE::Activate(), GetId(), IsToolActive(), and TOOL_BASE().

◆ m_toolMgr

TOOL_MANAGER* TOOL_BASE::m_toolMgr

protectedinherited

Definition at line 220 of file tool_base.h.

◆ m_toolName

std::string TOOL_BASE::m_toolName

protectedinherited

Names are expected to obey the format application.ToolName (eg.

pcbnew.InteractiveSelection).

Definition at line 219 of file tool_base.h.

Referenced by GetName(), and TOOL_BASE().

◆ m_type

TOOL_TYPE TOOL_BASE::m_type

protectedinherited

Definition at line 214 of file tool_base.h.

Referenced by GetType(), and TOOL_BASE().

The documentation for this class was generated from the following files:

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ RESET_REASON

◆ STOP_CONDITION

Constructor & Destructor Documentation

◆ PCB_SELECTION_TOOL()

◆ ~PCB_SELECTION_TOOL()

Member Function Documentation

◆ Activate()

◆ AddItemsToSel() [1/2]

◆ AddItemsToSel() [2/2]

◆ AddItemToSel() [1/2]

◆ AddItemToSel() [2/2]

◆ attachManager()

◆ board()

◆ BrightenItem()

◆ canvas()

◆ ClearSelection() [1/2]

◆ ClearSelection() [2/2]

◆ collectTableCellsAt()

◆ controls()

◆ ctrlClickHighlights()

◆ CursorSelection()

◆ disambiguateCursor()

◆ doSelectionMenu()

◆ doSyncSelection()

◆ editFrame()

◆ EnterGroup()

◆ ExitGroup()

◆ expandConnection()

◆ extendTableCellSelectionTo()

◆ FilterCollectedItems()

◆ FilterCollectorForFootprints()

◆ FilterCollectorForFreePads()

◆ FilterCollectorForHierarchy()

◆ FilterCollectorForLockedItems()

◆ FilterCollectorForMarkers()

◆ FilterCollectorForTableCells()

◆ filterSelection()

◆ FindItem()

◆ frame()

◆ GetActiveLayer()

◆ getCollectorsGuide()

◆ getEditFrame()

◆ GetEnteredGroup()

◆ GetFilter()

◆ GetId()

◆ GetManager()

◆ getModel()

◆ getModelInternal()

◆ GetName()

◆ GetSelection()

◆ getToolHolderInternal()

◆ GetToolMenu()

◆ GetType()

◆ getView()

◆ getViewControls()

◆ Go()

◆ goInternal()

◆ grabUnconnected()

◆ GuessSelectionCandidates()

◆ hasModifier()

◆ highlight()

◆ highlightInternal()

◆ hitTestDistance()

◆ Init()

◆ initializeTableCellSelectionState()

◆ isExpandableGraphicShape()

◆ IsFootprintEditor()

◆ IsToolActive()

◆ itemPassesFilter()

◆ Main()