Class that groups generic conditions for selected items. More...

#include <selection_conditions.h>

Inheritance diagram for SELECTION_CONDITIONS:

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

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

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

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

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

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

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.

static SELECTION_CONDITION	HasTypes (std::vector< KICAD_T > aTypes)
	Create a functor that tests if among the selected items there is at least one of a given types.

static SELECTION_CONDITION	OnlyTypes (std::vector< KICAD_T > aTypes)
	Create a functor that tests if the selected items are only of given types.

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.

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.

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.

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

static bool	hasTypesFunc (const SELECTION &aSelection, std::vector< KICAD_T > aTypes)
	Helper function used by HasTypes().

static bool	onlyTypesFunc (const SELECTION &aSelection, std::vector< KICAD_T > aTypes)
	Helper function used by OnlyTypes().

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

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

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

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

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

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

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

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

Friends
SELECTION_CONDITION	operator\|\| (const SELECTION_CONDITION &aConditionA, const SELECTION_CONDITION &aConditionB)

SELECTION_CONDITION	operator&& (const SELECTION_CONDITION &aConditionA, const SELECTION_CONDITION &aConditionB)

SELECTION_CONDITION	operator! (const SELECTION_CONDITION &aCondition)

SELECTION_CONDITION	operator\|\| (const SELECTION_CONDITION &aConditionA, SELECTION_BOOL aConditionB)

SELECTION_CONDITION	operator&& (const SELECTION_CONDITION &aConditionA, SELECTION_BOOL aConditionB)

Detailed Description

Class that groups generic conditions for selected items.

Definition at line 69 of file selection_conditions.h.

Member Function Documentation

◆ andBoolFunc()

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

inlinestaticprivate

Helper function used by operator &&.

Definition at line 202 of file selection_conditions.h.

◆ andFunc()

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

inlinestaticprivate

Helper function used by operator &&.

Definition at line 182 of file selection_conditions.h.

◆ Count()

SELECTION_CONDITION SELECTION_CONDITIONS::Count ( int aNumber )

static

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 79 of file selection_conditions.cpp.

References countFunc().

Referenced by SCH_POINT_EDITOR::Init(), SCH_SELECTION_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), SYMBOL_EDITOR_PIN_TOOL::Init(), CONVERT_TOOL::Init(), EDIT_TOOL::Init(), PAD_TOOL::Init(), PCB_POINT_EDITOR::Init(), PCB_SELECTION_TOOL::Init(), makeShapeModificationMenu(), and PCB_EDIT_FRAME::setupUIConditions().

◆ countFunc()

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

staticprivate

Helper function used by Count().

Definition at line 142 of file selection_conditions.cpp.

References SELECTION::Size().

Referenced by Count().

◆ Empty()

bool SELECTION_CONDITIONS::Empty ( const SELECTION & aSelection )

static

Test if there are no items selected.

Definition at line 41 of file selection_conditions.cpp.

References SELECTION::Empty().

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

◆ HasType()

SELECTION_CONDITION SELECTION_CONDITIONS::HasType ( KICAD_T aType )

static

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.

References hasTypeFunc().

Referenced by SCH_SELECTION_TOOL::Init(), EDIT_TOOL::Init(), PAD_TOOL::Init(), PCB_SELECTION_TOOL::Init(), SCH_EDIT_FRAME::setupUIConditions(), and FOOTPRINT_EDIT_FRAME::setupUIConditions().

◆ hasTypeFunc()

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

staticprivate

Helper function used by HasType().

Definition at line 97 of file selection_conditions.cpp.

References SELECTION::Empty().

Referenced by HasType().

◆ HasTypes()

SELECTION_CONDITION SELECTION_CONDITIONS::HasTypes ( std::vector< KICAD_T > aTypes )

static

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.

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

Definition at line 67 of file selection_conditions.cpp.

References hasTypesFunc().

Referenced by SCH_SELECTION_TOOL::Init(), EDIT_TOOL::Init(), makeShapeModificationMenu(), and PCB_EDIT_FRAME::setupUIConditions().

◆ hasTypesFunc()

bool SELECTION_CONDITIONS::hasTypesFunc	(	const SELECTION &	aSelection,
		std::vector< KICAD_T >	aTypes
	)

staticprivate

Helper function used by HasTypes().

Definition at line 112 of file selection_conditions.cpp.

References SELECTION::Empty().

Referenced by HasTypes().

◆ Idle()

bool SELECTION_CONDITIONS::Idle ( const SELECTION & aSelection )

static

Test if there no items selected or being edited.

Definition at line 47 of file selection_conditions.cpp.

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

Referenced by EDIT_TABLE_TOOL_BASE< T_TABLE, T_TABLECELL, T_COMMIT >::addMenus(), SCH_INSPECTION_TOOL::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), SCH_SELECTION_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 )

static

Test if all selected items are not being edited.

Definition at line 55 of file selection_conditions.cpp.

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

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

◆ LessThan()

SELECTION_CONDITION SELECTION_CONDITIONS::LessThan ( int aNumber )

static

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 91 of file selection_conditions.cpp.

References lessThanFunc().

Referenced by SCH_SELECTION_TOOL::Init().

◆ lessThanFunc()

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

staticprivate

Helper function used by LessThan().

Definition at line 154 of file selection_conditions.cpp.

References SELECTION::Size().

Referenced by LessThan().

◆ MoreThan()

SELECTION_CONDITION SELECTION_CONDITIONS::MoreThan ( int aNumber )

static

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 85 of file selection_conditions.cpp.

References moreThanFunc().

Referenced by EDIT_TABLE_TOOL_BASE< T_TABLE, T_TABLECELL, T_COMMIT >::addMenus(), SCH_LINE_WIRE_BUS_TOOL::Init(), SCH_SELECTION_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), CONVERT_TOOL::Init(), EDIT_TOOL::Init(), PCB_SELECTION_TOOL::Init(), ALIGN_DISTRIBUTE_TOOL::Init(), makeShapeModificationMenu(), and PCB_EDIT_FRAME::setupUIConditions().

◆ moreThanFunc()

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

staticprivate

Helper function used by MoreThan().

Definition at line 148 of file selection_conditions.cpp.

References SELECTION::Size().

Referenced by MoreThan().

◆ NotEmpty()

bool SELECTION_CONDITIONS::NotEmpty ( const SELECTION & aSelection )

static

Test if there are any items selected.

Definition at line 35 of file selection_conditions.cpp.

References SELECTION::Empty().

Referenced by GROUP_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), PL_EDIT_TOOL::Init(), ROUTER_TOOL::Init(), BOARD_EDITOR_CONTROL::Init(), EDIT_TOOL::Init(), PCB_SELECTION_TOOL::Init(), makePositioningToolsMenu(), SCH_EDIT_FRAME::setupUIConditions(), PL_EDITOR_FRAME::setupUIConditions(), FOOTPRINT_EDIT_FRAME::setupUIConditions(), and PCB_EDIT_FRAME::setupUIConditions().

◆ notFunc()

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

inlinestaticprivate

Helper function used by operator !.

Definition at line 189 of file selection_conditions.h.

◆ OnlyTypes()

SELECTION_CONDITION SELECTION_CONDITIONS::OnlyTypes ( std::vector< KICAD_T > aTypes )

static

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

Parameters

aTypes is an array containing types that are searched.

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

Definition at line 73 of file selection_conditions.cpp.

References onlyTypesFunc().

Referenced by EDIT_TABLE_TOOL_BASE< T_TABLE, T_TABLECELL, T_COMMIT >::addMenus(), SCH_LINE_WIRE_BUS_TOOL::Init(), SCH_MOVE_TOOL::Init(), SCH_SELECTION_TOOL::Init(), SYMBOL_EDITOR_EDIT_TOOL::Init(), SYMBOL_EDITOR_PIN_TOOL::Init(), BOARD_EDITOR_CONTROL::Init(), CONVERT_TOOL::Init(), EDIT_TOOL::Init(), PAD_TOOL::Init(), PCB_SELECTION_TOOL::Init(), makeShapeModificationMenu(), SCH_EDIT_TOOL::Properties(), 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,
		std::vector< KICAD_T >	aTypes
	)

staticprivate

Helper function used by OnlyTypes().

Definition at line 127 of file selection_conditions.cpp.

References SELECTION::Empty().

Referenced by OnlyTypes().

◆ orBoolFunc()

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

inlinestaticprivate

Helper function used by operator ||.

Definition at line 195 of file selection_conditions.h.

◆ orFunc()

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

inlinestaticprivate

Helper function used by operator ||.

Definition at line 175 of file selection_conditions.h.

◆ ShowAlways()

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

inlinestatic

The default condition function (always returns true).

Definition at line 75 of file selection_conditions.h.

Referenced by ACTION_CONDITIONS::ACTION_CONDITIONS(), DESIGN_BLOCK_CONTROL::AddContextMenuItems(), LIBRARY_EDITOR_CONTROL::AddContextMenuItems(), CONDITIONAL_MENU::AddSeparator(), EDA_DRAW_FRAME::AddStandardSubMenus(), EDA_3D_CONTROLLER::Init(), SCH_LINE_WIRE_BUS_TOOL::Init(), SCH_TOOL_BASE< T >::Init(), PICKER_TOOL::Init(), ZOOM_TOOL::Init(), PL_DRAWING_TOOLS::Init(), PL_EDIT_TOOL::Init(), ROUTER_TOOL::Init(), FOOTPRINT_CHOOSER_SELECTION_TOOL::Init(), FOOTPRINT_EDITOR_CONTROL::Init(), GENERATOR_TOOL::Init(), PAD_TOOL::Init(), PCB_PICKER_TOOL::Init(), PCB_TOOL_BASE::Init(), LOCK_CONTEXT_MENU::LOCK_CONTEXT_MENU(), SCH_EDIT_FRAME::setupUIConditions(), SIMULATOR_FRAME::setupUIConditions(), SYMBOL_EDIT_FRAME::setupUIConditions(), PL_EDITOR_FRAME::setupUIConditions(), FOOTPRINT_EDIT_FRAME::setupUIConditions(), and PCB_EDIT_FRAME::setupUIConditions().

◆ ShowNever()

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

inlinestatic

Always returns false.

Definition at line 80 of file selection_conditions.h.

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

Friends And Related Function Documentation

◆ operator!

SELECTION_CONDITION operator! ( const SELECTION_CONDITION & aCondition )

friend

Definition at line 174 of file selection_conditions.cpp.

◆ operator&& [1/2]

SELECTION_CONDITION operator&&	(	const SELECTION_CONDITION &	aConditionA,
		const SELECTION_CONDITION &	aConditionB
	)

friend

Definition at line 167 of file selection_conditions.cpp.

◆ operator&& [2/2]

SELECTION_CONDITION operator&&	(	const SELECTION_CONDITION &	aConditionA,
		SELECTION_BOOL	aConditionB
	)

friend

Definition at line 194 of file selection_conditions.cpp.

◆ operator|| [1/2]

SELECTION_CONDITION operator\|\|	(	const SELECTION_CONDITION &	aConditionA,
		const SELECTION_CONDITION &	aConditionB
	)

friend

Definition at line 160 of file selection_conditions.cpp.

◆ operator|| [2/2]

SELECTION_CONDITION operator\|\|	(	const SELECTION_CONDITION &	aConditionA,
		SELECTION_BOOL	aConditionB
	)

friend

Definition at line 180 of file selection_conditions.cpp.

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

Static Public Member Functions

Static Private Member Functions

Friends

Detailed Description

Member Function Documentation

◆ andBoolFunc()

◆ andFunc()

◆ Count()

◆ countFunc()

◆ Empty()

◆ HasType()

◆ hasTypeFunc()

◆ HasTypes()

◆ hasTypesFunc()

◆ Idle()

◆ IdleSelection()

◆ LessThan()

◆ lessThanFunc()

◆ MoreThan()

◆ moreThanFunc()

◆ NotEmpty()

◆ notFunc()

◆ OnlyTypes()

◆ onlyTypesFunc()

◆ orBoolFunc()

◆ orFunc()

◆ ShowAlways()

◆ ShowNever()

Friends And Related Function Documentation

◆ operator!

◆ operator&& [1/2]

◆ operator&& [2/2]

◆ operator|| [1/2]

◆ operator|| [2/2]