#include <ee_selection_tool.h>

Inheritance diagram for EE_CONDITIONS:

Static Public Member Functions
static bool	ShowAlways (const SELECTION &aSelection)
	The default condition function (always returns true). More...

static bool	ShowNever (const SELECTION &aSelection)
	Always returns false. More...

static bool	NotEmpty (const SELECTION &aSelection)
	Test if there are any items selected. More...

static bool	Empty (const SELECTION &aSelection)
	Test if there are no items selected. More...

static bool	Idle (const SELECTION &aSelection)
	Test if there no items selected or being edited. More...

static bool	IdleSelection (const SELECTION &aSelection)
	Test if all selected items are not being edited. More...

static SELECTION_CONDITION	HasType (KICAD_T aType)
	Create a functor that tests if among the selected items there is at least one of a given type. More...

static SELECTION_CONDITION	HasTypes (const KICAD_T aTypes[])
	Create a functor that tests if among the selected items there is at least one of a given types. More...

static SELECTION_CONDITION	OnlyType (KICAD_T aType)
	Create a functor that tests if the selected items are only of given type. More...

static SELECTION_CONDITION	OnlyTypes (const KICAD_T aTypes[])
	Create a functor that tests if the selected items are only of given types. More...

static SELECTION_CONDITION	Count (int aNumber)
	Create a functor that tests if the number of selected items is equal to the value given as parameter. More...

static SELECTION_CONDITION	MoreThan (int aNumber)
	Create a functor that tests if the number of selected items is greater than the value given as parameter. More...

static SELECTION_CONDITION	LessThan (int aNumber)
	Create a functor that tests if the number of selected items is smaller than the value given as parameter. More...

Static Public Attributes
static SELECTION_CONDITION	SingleSymbol

static SELECTION_CONDITION	SingleSymbolOrPower

static SELECTION_CONDITION	SingleDeMorganSymbol

static SELECTION_CONDITION	SingleMultiUnitSymbol

static SELECTION_CONDITION	SingleNonExcludedMarker

Static Private Member Functions
static bool	hasTypeFunc (const SELECTION &aSelection, KICAD_T aType)
	< Helper function used by HasType() More...

static bool	hasTypesFunc (const SELECTION &aSelection, const KICAD_T aTypes[])
	Helper function used by OnlyType() More...

static bool	onlyTypeFunc (const SELECTION &aSelection, KICAD_T aType)
	Helper function used by OnlyTypes() More...

static bool	onlyTypesFunc (const SELECTION &aSelection, const KICAD_T aTypes[])
	Helper function used by Count() More...

static bool	countFunc (const SELECTION &aSelection, int aNumber)
	Helper function used by MoreThan() More...

static bool	moreThanFunc (const SELECTION &aSelection, int aNumber)
	Helper function used by LessThan() More...

static bool	lessThanFunc (const SELECTION &aSelection, int aNumber)
	Helper function used by operator\|\|. More...

static bool	orFunc (const SELECTION_CONDITION &aConditionA, const SELECTION_CONDITION &aConditionB, const SELECTION &aSelection)
	Helper function used by operator&&. More...

static bool	andFunc (const SELECTION_CONDITION &aConditionA, const SELECTION_CONDITION &aConditionB, const SELECTION &aSelection)
	Helper function used by operator! More...

static bool	notFunc (const SELECTION_CONDITION &aCondition, const SELECTION &aSelection)
	Helper function used by operator\|\|. More...

static bool	orBoolFunc (const SELECTION_CONDITION &aConditionA, SELECTION_BOOL &aConditionB, const SELECTION &aSelection)
	Helper function used by operator&&. More...

static bool	andBoolFunc (const SELECTION_CONDITION &aConditionA, SELECTION_BOOL &aConditionB, const SELECTION &aSelection)

Detailed Description

Definition at line 46 of file ee_selection_tool.h.

Member Function Documentation

◆ andBoolFunc()

static bool SELECTION_CONDITIONS::andBoolFunc	(	const SELECTION_CONDITION &	aConditionA,
		SELECTION_BOOL &	aConditionB,
		const SELECTION &	aSelection
	)

inlinestaticprivateinherited

Definition at line 238 of file selection_conditions.h.

 {
 return aConditionA( aSelection ) && aConditionB( aSelection );
 }

◆ andFunc()

static bool SELECTION_CONDITIONS::andFunc	(	const SELECTION_CONDITION &	aConditionA,
		const SELECTION_CONDITION &	aConditionB,
		const SELECTION &	aSelection
	)

inlinestaticprivateinherited

Helper function used by operator!

Definition at line 218 of file selection_conditions.h.

◆ Count()

SELECTION_CONDITION SELECTION_CONDITIONS::Count ( int aNumber )

staticinherited

Create a functor that tests if the number of selected items is equal to the value given as parameter.

Parameters

aNumber is the number of expected items.

Returns: Functor testing if the number of selected items is equal aNumber.

Definition at line 85 of file selection_conditions.cpp.

{
 return std::bind( &SELECTION_CONDITIONS::countFunc, _1, aNumber );
}

References SELECTION_CONDITIONS::countFunc().

Referenced by EE_SELECTION_TOOL::Init(), SCH_EDIT_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), SYMBOL_EDITOR_PIN_TOOL::Init(), BOARD_INSPECTION_TOOL::Init(), CONVERT_TOOL::Init(), EDIT_TOOL::Init(), PAD_TOOL::Init(), and PCB_EDIT_FRAME::setupUIConditions().

◆ countFunc()

bool SELECTION_CONDITIONS::countFunc	(	const SELECTION &	aSelection,
		int	aNumber
	)

staticprivateinherited

Helper function used by MoreThan()

Definition at line 165 of file selection_conditions.cpp.

{
 return aSelection.Size() == aNumber;
}

References SELECTION::Size().

Referenced by SELECTION_CONDITIONS::Count().

◆ Empty()

bool SELECTION_CONDITIONS::Empty ( const SELECTION & aSelection )

staticinherited

Test if there are no items selected.

Parameters

aSelection is the selection to be tested.

Returns: True if there are no items selected.

Definition at line 41 of file selection_conditions.cpp.

{
 return aSelection.Empty();
}

References SELECTION::Empty().

Referenced by EE_SELECTION_TOOL::Init(), and PL_SELECTION_TOOL::Init().

◆ HasType()

SELECTION_CONDITION SELECTION_CONDITIONS::HasType ( KICAD_T aType )

staticinherited

Create a functor that tests if among the selected items there is at least one of a given type.

Parameters

aType is the type that is searched.

Returns: Functor testing for presence of items of a given type.

Definition at line 61 of file selection_conditions.cpp.

{
 return std::bind( &SELECTION_CONDITIONS::hasTypeFunc, _1, aType );
}

References SELECTION_CONDITIONS::hasTypeFunc().

Referenced by PAD_TOOL::Init().

◆ hasTypeFunc()

bool SELECTION_CONDITIONS::hasTypeFunc	(	const SELECTION &	aSelection,
		KICAD_T	aType
	)

staticprivateinherited

< Helper function used by HasType()

Helper function used by HasTypes()

Definition at line 103 of file selection_conditions.cpp.

{
 if( aSelection.Empty() )
 return false;
 
 for( const EDA_ITEM* item : aSelection )
 {
 if( item->Type() == aType )
 return true;
 }
 
 return false;
}

References SELECTION::Empty().

Referenced by SELECTION_CONDITIONS::HasType().

◆ HasTypes()

SELECTION_CONDITION SELECTION_CONDITIONS::HasTypes ( const KICAD_T aTypes[] )

staticinherited

Create a functor that tests if among the selected items there is at least one of a given types.

Parameters

aTypes is an array containing types that are searched. It has to be ended with #KICAD_T::EOT as end marker.

Returns: Functor testing for presence of items of a given types.

Definition at line 67 of file selection_conditions.cpp.

{
 return std::bind( &SELECTION_CONDITIONS::hasTypesFunc, _1, aTypes );
}

References SELECTION_CONDITIONS::hasTypesFunc().

Referenced by EE_SELECTION_TOOL::Init().

◆ hasTypesFunc()

bool SELECTION_CONDITIONS::hasTypesFunc	(	const SELECTION &	aSelection,
		const KICAD_T	aTypes[]
	)

staticprivateinherited

Helper function used by OnlyType()

Definition at line 118 of file selection_conditions.cpp.

{
 if( aSelection.Empty() )
 return false;
 
 for( const EDA_ITEM* item : aSelection )
 {
 if( item->IsType( aTypes ) )
 return true;
 }
 
 return false;
}

References SELECTION::Empty().

Referenced by SELECTION_CONDITIONS::HasTypes().

◆ Idle()

bool SELECTION_CONDITIONS::Idle ( const SELECTION & aSelection )

staticinherited

Test if there no items selected or being edited.

Parameters

aSelection is the selection to be tested.

Returns: True if there are no items being edited or no items selected.

Definition at line 47 of file selection_conditions.cpp.

{
 constexpr int busyMask = ( IS_NEW | IS_PASTED | IS_MOVING | IS_RESIZING | IS_DRAGGING );
 
 return !aSelection.Front() || ( aSelection.Front()->GetEditFlags() & busyMask ) == 0;
}

References SELECTION::Front(), EDA_ITEM::GetEditFlags(), IS_DRAGGING, IS_MOVING, IS_NEW, IS_PASTED, and IS_RESIZING.

Referenced by EE_INSPECTION_TOOL::Init(), EE_SELECTION_TOOL::Init(), SCH_EDIT_TOOL::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), SCH_EDIT_FRAME::setupUIConditions(), SYMBOL_EDIT_FRAME::setupUIConditions(), PL_EDITOR_FRAME::setupUIConditions(), FOOTPRINT_EDIT_FRAME::setupUIConditions(), and PCB_EDIT_FRAME::setupUIConditions().

◆ IdleSelection()

bool SELECTION_CONDITIONS::IdleSelection ( const SELECTION & aSelection )

staticinherited

Test if all selected items are not being edited.

Parameters

aSelection is the selection to be tested.

Returns: True if no selected items are being edited.

Definition at line 55 of file selection_conditions.cpp.

{
 return ( aSelection.Front() && aSelection.Front()->GetEditFlags() == 0 );
}

References SELECTION::Front(), and EDA_ITEM::GetEditFlags().

Referenced by SCH_EDIT_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), and SYMBOL_EDITOR_MOVE_TOOL::Init().

◆ LessThan()

SELECTION_CONDITION SELECTION_CONDITIONS::LessThan ( int aNumber )

staticinherited

Create a functor that tests if the number of selected items is smaller than the value given as parameter.

Parameters

aNumber is the number used for comparison.

Returns: Functor testing if the number of selected items is smaller than aNumber.

Definition at line 97 of file selection_conditions.cpp.

{
 return std::bind( &SELECTION_CONDITIONS::lessThanFunc, _1, aNumber );
}

References SELECTION_CONDITIONS::lessThanFunc().

Referenced by EE_SELECTION_TOOL::Init().

◆ lessThanFunc()

bool SELECTION_CONDITIONS::lessThanFunc	(	const SELECTION &	aSelection,
		int	aNumber
	)

staticprivateinherited

Helper function used by operator||.

Definition at line 177 of file selection_conditions.cpp.

{
 return aSelection.Size() < aNumber;
}

References SELECTION::Size().

Referenced by SELECTION_CONDITIONS::LessThan().

◆ MoreThan()

SELECTION_CONDITION SELECTION_CONDITIONS::MoreThan ( int aNumber )

staticinherited

Create a functor that tests if the number of selected items is greater than the value given as parameter.

Parameters

aNumber is the number used for comparison.

Returns: Functor testing if the number of selected items is greater than aNumber.

Definition at line 91 of file selection_conditions.cpp.

{
 return std::bind( &SELECTION_CONDITIONS::moreThanFunc, _1, aNumber );
}

References SELECTION_CONDITIONS::moreThanFunc().

Referenced by EE_SELECTION_TOOL::Init(), SCH_EDIT_TOOL::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), CONVERT_TOOL::Init(), ALIGN_DISTRIBUTE_TOOL::Init(), FOOTPRINT_EDIT_FRAME::setupUIConditions(), and PCB_EDIT_FRAME::setupUIConditions().

◆ moreThanFunc()

bool SELECTION_CONDITIONS::moreThanFunc	(	const SELECTION &	aSelection,
		int	aNumber
	)

staticprivateinherited

Helper function used by LessThan()

Definition at line 171 of file selection_conditions.cpp.

{
 return aSelection.Size() > aNumber;
}

References SELECTION::Size().

Referenced by SELECTION_CONDITIONS::MoreThan().

◆ NotEmpty()

bool SELECTION_CONDITIONS::NotEmpty ( const SELECTION & aSelection )

staticinherited

Test if there are any items selected.

Parameters

aSelection is the selection to be tested.

Returns: True if there is at least one item selected.

Definition at line 35 of file selection_conditions.cpp.

{
 return !aSelection.Empty();
}

References SELECTION::Empty().

Referenced by SCH_EDIT_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), PL_EDIT_TOOL::Init(), BOARD_EDITOR_CONTROL::Init(), EDIT_TOOL::Init(), GROUP_TOOL::Init(), PCB_SELECTION_TOOL::Init(), and PL_EDITOR_FRAME::setupUIConditions().

◆ notFunc()

static bool SELECTION_CONDITIONS::notFunc	(	const SELECTION_CONDITION &	aCondition,
		const SELECTION &	aSelection
	)

inlinestaticprivateinherited

Helper function used by operator||.

Definition at line 225 of file selection_conditions.h.

◆ OnlyType()

SELECTION_CONDITION SELECTION_CONDITIONS::OnlyType ( KICAD_T aType )

staticinherited

Create a functor that tests if the selected items are only of given type.

Parameters

aType is the type that is searched.

Returns: Functor testing if selected items are exclusively of one type.

Definition at line 73 of file selection_conditions.cpp.

{
 return std::bind( &SELECTION_CONDITIONS::onlyTypeFunc, _1, aType );
}

References SELECTION_CONDITIONS::onlyTypeFunc().

Referenced by EE_SELECTION_TOOL::Init(), SCH_EDIT_TOOL::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), SCH_MOVE_TOOL::Init(), SYMBOL_EDITOR_PIN_TOOL::Init(), BOARD_EDITOR_CONTROL::Init(), CONVERT_TOOL::Init(), EDIT_TOOL::Init(), PAD_TOOL::Init(), and PCB_EDIT_FRAME::setupUIConditions().

◆ onlyTypeFunc()

bool SELECTION_CONDITIONS::onlyTypeFunc	(	const SELECTION &	aSelection,
		KICAD_T	aType
	)

staticprivateinherited

Helper function used by OnlyTypes()

Definition at line 133 of file selection_conditions.cpp.

{
 if( aSelection.Empty() )
 return false;
 
 KICAD_T types[] = { aType, EOT };
 
 for( const EDA_ITEM* item : aSelection )
 {
 if( !item->IsType( types ) )
 return false;
 }
 
 return true;
}

References SELECTION::Empty(), and EOT.

Referenced by SELECTION_CONDITIONS::OnlyType().

◆ OnlyTypes()

SELECTION_CONDITION SELECTION_CONDITIONS::OnlyTypes ( const KICAD_T aTypes[] )

staticinherited

Create a functor that tests if the selected items are only of given types.

Parameters

aTypes is an array containing types that are searched. It has to be ended with #KICAD_T::EOT as end marker.

Returns: Functor testing if selected items are exclusively of the requested types.

Definition at line 79 of file selection_conditions.cpp.

{
 return std::bind( &SELECTION_CONDITIONS::onlyTypesFunc, _1, aTypes );
}

References SELECTION_CONDITIONS::onlyTypesFunc().

Referenced by EE_SELECTION_TOOL::Init(), SCH_EDIT_TOOL::Init(), BOARD_INSPECTION_TOOL::Init(), CONVERT_TOOL::Init(), EDIT_TOOL::Init(), EDIT_TOOL::Properties(), PCB_EDIT_FRAME::setupUIConditions(), BOARD_EDITOR_CONTROL::TrackWidthDec(), BOARD_EDITOR_CONTROL::TrackWidthInc(), BOARD_EDITOR_CONTROL::ViaSizeDec(), and BOARD_EDITOR_CONTROL::ViaSizeInc().

◆ onlyTypesFunc()

bool SELECTION_CONDITIONS::onlyTypesFunc	(	const SELECTION &	aSelection,
		const KICAD_T	aTypes[]
	)

staticprivateinherited

Helper function used by Count()

Definition at line 150 of file selection_conditions.cpp.

{
 if( aSelection.Empty() )
 return false;
 
 for( const EDA_ITEM* item : aSelection )
 {
 if( !item->IsType( aTypes ) )
 return false;
 }
 
 return true;
}

References SELECTION::Empty().

Referenced by SELECTION_CONDITIONS::OnlyTypes().

◆ orBoolFunc()

static bool SELECTION_CONDITIONS::orBoolFunc	(	const SELECTION_CONDITION &	aConditionA,
		SELECTION_BOOL &	aConditionB,
		const SELECTION &	aSelection
	)

inlinestaticprivateinherited

Helper function used by operator&&.

Definition at line 231 of file selection_conditions.h.

◆ orFunc()

static bool SELECTION_CONDITIONS::orFunc	(	const SELECTION_CONDITION &	aConditionA,
		const SELECTION_CONDITION &	aConditionB,
		const SELECTION &	aSelection
	)

inlinestaticprivateinherited

Helper function used by operator&&.

Definition at line 211 of file selection_conditions.h.

◆ ShowAlways()

static bool SELECTION_CONDITIONS::ShowAlways ( const SELECTION & aSelection )

inlinestaticinherited

The default condition function (always returns true).

Parameters

aSelection is the selection to be tested.

Returns: Always true.

Definition at line 77 of file selection_conditions.h.

 {
 return true;
 }

Referenced by ACTION_CONDITIONS::ACTION_CONDITIONS(), CONDITIONAL_MENU::AddSeparator(), EDA_DRAW_FRAME::AddStandardSubMenus(), EDA_3D_CONTROLLER::Init(), EE_TOOL_BASE< T >::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), PICKER_TOOL::Init(), ZOOM_TOOL::Init(), PL_DRAWING_TOOLS::Init(), PL_EDIT_TOOL::Init(), LENGTH_TUNER_TOOL::Init(), ROUTER_TOOL::Init(), DRAWING_TOOL::Init(), PAD_TOOL::Init(), PCB_TOOL_BASE::Init(), SCH_EDIT_FRAME::setupUIConditions(), SYMBOL_EDIT_FRAME::setupUIConditions(), PL_EDITOR_FRAME::setupUIConditions(), FOOTPRINT_EDIT_FRAME::setupUIConditions(), PCB_EDIT_FRAME::setupUIConditions(), and SPECIAL_TOOLS_CONTEXT_MENU::SPECIAL_TOOLS_CONTEXT_MENU().

◆ ShowNever()

static bool SELECTION_CONDITIONS::ShowNever ( const SELECTION & aSelection )

inlinestaticinherited

Always returns false.

Parameters

aSelection is the selection to be tested.

Returns: Always false.

Definition at line 88 of file selection_conditions.h.

 {
 return false;
 }

Referenced by ACTION_CONDITIONS::ACTION_CONDITIONS(), KICAD_MANAGER_FRAME::setupUIConditions(), and PL_EDITOR_FRAME::setupUIConditions().

Member Data Documentation

◆ SingleDeMorganSymbol

SELECTION_CONDITION EE_CONDITIONS::SingleDeMorganSymbol

static

Initial value:

= []( const SELECTION& aSel )
{
 if( aSel.GetSize() == 1 )
 {
 SCH_SYMBOL* symbol = dynamic_cast<SCH_SYMBOL*>( aSel.Front() );
 
 if( symbol )
 return symbol->GetLibSymbolRef() && symbol->GetLibSymbolRef()->HasConversion();
 }
 
 return false;
}

Definition at line 51 of file ee_selection_tool.h.

Referenced by SCH_EDIT_TOOL::Init().

◆ SingleMultiUnitSymbol

SELECTION_CONDITION EE_CONDITIONS::SingleMultiUnitSymbol

static

Initial value:

= []( const SELECTION& aSel )
{
 if( aSel.GetSize() == 1 )
 {
 SCH_SYMBOL* symbol = dynamic_cast<SCH_SYMBOL*>( aSel.Front() );
 
 if( symbol )
 return symbol->GetLibSymbolRef() && symbol->GetLibSymbolRef()->GetUnitCount() >= 2;
 }
 
 return false;
}

Definition at line 52 of file ee_selection_tool.h.

Referenced by SCH_EDIT_TOOL::Init().

◆ SingleNonExcludedMarker

SELECTION_CONDITION EE_CONDITIONS::SingleNonExcludedMarker

static

Initial value:

= []( const SELECTION& aSel )
{
 if( aSel.CountType( SCH_MARKER_T ) != 1 )
 return false;
 
 return !static_cast<SCH_MARKER*>( aSel.Front() )->IsExcluded();
}

Definition at line 53 of file ee_selection_tool.h.

Referenced by EE_INSPECTION_TOOL::Init().

◆ SingleSymbol

SELECTION_CONDITION EE_CONDITIONS::SingleSymbol

static

Initial value:

= []( const SELECTION& aSel )
{
 if( aSel.GetSize() == 1 )
 {
 SCH_SYMBOL* symbol = dynamic_cast<SCH_SYMBOL*>( aSel.Front() );
 
 if( symbol )
 return !symbol->GetLibSymbolRef() || !symbol->GetLibSymbolRef()->IsPower();
 }
 
 return false;
}

Definition at line 49 of file ee_selection_tool.h.

Referenced by EE_INSPECTION_TOOL::Init(), and SCH_EDIT_TOOL::Init().

◆ SingleSymbolOrPower

SELECTION_CONDITION EE_CONDITIONS::SingleSymbolOrPower

static

Initial value:

= []( const SELECTION& aSel )
{
 return aSel.GetSize() == 1 && aSel.Front()->Type() == SCH_SYMBOL_T;
}

Definition at line 50 of file ee_selection_tool.h.

Referenced by SCH_EDIT_TOOL::Init().

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

Static Public Member Functions

Static Public Attributes

Static Private Member Functions

Detailed Description

Member Function Documentation

◆ andBoolFunc()

◆ andFunc()

◆ Count()

◆ countFunc()

◆ Empty()

◆ HasType()

◆ hasTypeFunc()

◆ HasTypes()

◆ hasTypesFunc()

◆ Idle()

◆ IdleSelection()

◆ LessThan()

◆ lessThanFunc()

◆ MoreThan()

◆ moreThanFunc()

◆ NotEmpty()

◆ notFunc()

◆ OnlyType()

◆ onlyTypeFunc()

◆ OnlyTypes()

◆ onlyTypesFunc()

◆ orBoolFunc()

◆ orFunc()

◆ ShowAlways()

◆ ShowNever()

Member Data Documentation

◆ SingleDeMorganSymbol

◆ SingleMultiUnitSymbol

◆ SingleNonExcludedMarker

◆ SingleSymbol

◆ SingleSymbolOrPower