Provide class metadata.Helper macro to map type hashes to names. More...

#include <property_mgr.h>

Classes
struct	CLASS_DESC
	Returns metadata for a specific type. More...

struct	CLASS_INFO

Public Types
typedef std::vector< CLASS_INFO >	CLASSES_INFO

Public Member Functions
void	RegisterType (TYPE_ID aType, const wxString &aName)
	Associate a name with a type.

PROPERTY_BASE *	GetProperty (TYPE_ID aType, const wxString &aProperty) const
	Return a property for a specific type.

const std::vector< PROPERTY_BASE * > &	GetProperties (TYPE_ID aType) const
	Return all properties for a specific type.

const std::map< PROPERTY_BASE *, int > &	GetDisplayOrder (TYPE_ID aType) const

const std::vector< wxString > &	GetGroupDisplayOrder (TYPE_ID aType) const

const void *	TypeCast (const void *aSource, TYPE_ID aBase, TYPE_ID aTarget) const
	Cast a type to another type.

void *	TypeCast (void *aSource, TYPE_ID aBase, TYPE_ID aTarget) const

PROPERTY_BASE &	AddProperty (PROPERTY_BASE *aProperty, const wxString &aGroup=wxEmptyString)
	Register a property.

PROPERTY_BASE &	ReplaceProperty (size_t aBase, const wxString &aName, PROPERTY_BASE *aNew, const wxString &aGroup=wxEmptyString)
	Replace an existing property for a specific type.

void	AddTypeCast (TYPE_CAST_BASE *aCast)
	Register a type converter.

void	InheritsAfter (TYPE_ID aDerived, TYPE_ID aBase)
	Declare an inheritance relationship between types.

void	Mask (TYPE_ID aDerived, TYPE_ID aBase, const wxString &aName)
	Sets a base class property as masked in a derived class.

void	OverrideAvailability (TYPE_ID aDerived, TYPE_ID aBase, const wxString &aName, std::function< bool(INSPECTABLE *)> aFunc)
	Sets an override availability functor for a base class property of a given derived class.

void	OverrideWriteability (TYPE_ID aDerived, TYPE_ID aBase, const wxString &aName, std::function< bool(INSPECTABLE *)> aFunc)
	Sets an override writeability functor for a base class property of a given derived class.

bool	IsAvailableFor (TYPE_ID aItemClass, PROPERTY_BASE aProp, INSPECTABLE aItem)
	Checks overriden availability and original availability of a property, returns false if the property is unavailable in either case.

bool	IsWriteableFor (TYPE_ID aItemClass, PROPERTY_BASE aProp, INSPECTABLE aItem)
	Checks overriden availability and original availability of a property, returns false if the property is unavailable in either case.

bool	IsOfType (TYPE_ID aDerived, TYPE_ID aBase) const
	Return true if aDerived is inherited from aBase.

void	Rebuild ()
	Rebuild the list of all registered properties.

CLASSES_INFO	GetAllClasses ()

void	PropertyChanged (INSPECTABLE aObject, PROPERTY_BASE aProperty)
	Callback to alert the notification system that a property has changed.

void	RegisterListener (TYPE_ID aType, PROPERTY_LISTENER aListenerFunc)
	Registers a listener for the given type.

void	UnregisterListeners (TYPE_ID aType)

Static Public Member Functions
static PROPERTY_MANAGER &	Instance ()

Private Member Functions
	PROPERTY_MANAGER ()

CLASS_DESC &	getClass (TYPE_ID aTypeId)

Private Attributes
std::unordered_map< TYPE_ID, wxString >	m_classNames
	Map of all available types.

std::unordered_map< TYPE_ID, CLASS_DESC >	m_classes

bool	m_dirty
	Flag indicating that the list of properties needs to be rebuild (RebuildProperties())

std::map< TYPE_ID, std::vector< PROPERTY_LISTENER > >	m_listeners

COMMIT *	m_managedCommit

Friends
class	PROPERTY_COMMIT_HANDLER
	Structure holding type meta-data.

Detailed Description

Provide class metadata.Helper macro to map type hashes to names.

Each class handled by PROPERTY_MANAGER needs to be described using AddProperty(), AddTypeCast() and InheritsAfter() methods.

Enum types use a dedicated property type (PROPERTY_ENUM), define its possible values with ENUM_MAP class, then describe the type using macros:

DECLARE_ENUM_TO_WXANY (in header files)
IMPLEMENT_ENUM_TO_WXANY (in source files)
ENUM_TO_WXANY (most often used; combines DECLARE and IMPLEMENT macros, if there is no need to share the description using header files)

Once all classes are described, the property list must be build using Rebuild() method.

Definition at line 73 of file property_mgr.h.

Member Typedef Documentation

◆ CLASSES_INFO

typedef std::vector<CLASS_INFO> PROPERTY_MANAGER::CLASSES_INFO

Definition at line 238 of file property_mgr.h.

Constructor & Destructor Documentation

◆ PROPERTY_MANAGER()

PROPERTY_MANAGER::PROPERTY_MANAGER ( )

inlineprivate

Definition at line 265 of file property_mgr.h.

References m_dirty, and m_managedCommit.

Referenced by GetDisplayOrder(), GetGroupDisplayOrder(), GetProperties(), GetProperty(), and Instance().

Member Function Documentation

◆ AddProperty()

PROPERTY_BASE & PROPERTY_MANAGER::AddProperty	(	PROPERTY_BASE *	aProperty,
		const wxString &	aGroup = wxEmptyString )

Register a property.

Properties for a given item will be shown in the order they are added. If a group name is supplied, the group will be created if it does not yet exists. Groups will likewise be shown in the order they are added (so, groups first added by a base class will appear before those of a child class).

Parameters

aProperty	is the property to register.
aGroup	is an optional grouping key for the property

Definition at line 130 of file property_mgr.cpp.

References getClass(), m_dirty, PROPERTY_MANAGER::CLASS_DESC::m_groupDisplayOrder, PROPERTY_MANAGER::CLASS_DESC::m_groups, PROPERTY_MANAGER::CLASS_DESC::m_ownDisplayOrder, PROPERTY_MANAGER::CLASS_DESC::m_ownProperties, PROPERTY_BASE::Name(), name, PROPERTY_BASE::OwnerHash(), and PROPERTY_BASE::SetGroup().

Referenced by ALIGNED_DIMENSION_DESC::ALIGNED_DIMENSION_DESC(), BOARD_CONNECTED_ITEM_DESC::BOARD_CONNECTED_ITEM_DESC(), BOARD_ITEM_DESC::BOARD_ITEM_DESC(), CLASS_A_DESC::CLASS_A_DESC(), CLASS_B_DESC::CLASS_B_DESC(), CLASS_C_DESC::CLASS_C_DESC(), CLASS_D_DESC::CLASS_D_DESC(), DIMENSION_DESC::DIMENSION_DESC(), EDA_ITEM_DESC::EDA_ITEM_DESC(), EDA_SHAPE_DESC::EDA_SHAPE_DESC(), EDA_TEXT_DESC::EDA_TEXT_DESC(), FOOTPRINT_DESC::FOOTPRINT_DESC(), LEADER_DIMENSION_DESC::LEADER_DIMENSION_DESC(), PAD_DESC::PAD_DESC(), PCB_FIELD_DESC::PCB_FIELD_DESC(), PCB_GROUP_DESC::PCB_GROUP_DESC(), PCB_POINT_DESC::PCB_POINT_DESC(), PCB_REFERENCE_IMAGE_DESC::PCB_REFERENCE_IMAGE_DESC(), PCB_SHAPE_DESC::PCB_SHAPE_DESC(), PCB_TABLE_DESC::PCB_TABLE_DESC(), PCB_TABLECELL_DESC::PCB_TABLECELL_DESC(), PCB_TARGET_DESC::PCB_TARGET_DESC(), PCB_TEXT_DESC::PCB_TEXT_DESC(), PCB_TEXTBOX_DESC::PCB_TEXTBOX_DESC(), PCB_TUNING_PATTERN_DESC::PCB_TUNING_PATTERN_DESC(), RADIAL_DIMENSION_DESC::RADIAL_DIMENSION_DESC(), ReplaceProperty(), SCH_BITMAP_DESC::SCH_BITMAP_DESC(), SCH_BUS_ENTRY_DESC::SCH_BUS_ENTRY_DESC(), SCH_DIRECTIVE_LABEL_DESC::SCH_DIRECTIVE_LABEL_DESC(), SCH_FIELD_DESC::SCH_FIELD_DESC(), SCH_GROUP_DESC::SCH_GROUP_DESC(), SCH_ITEM_DESC::SCH_ITEM_DESC(), SCH_JUNCTION_DESC::SCH_JUNCTION_DESC(), SCH_LABEL_DESC::SCH_LABEL_DESC(), SCH_LINE_DESC::SCH_LINE_DESC(), SCH_PIN_DESC::SCH_PIN_DESC(), SCH_SHAPE_DESC::SCH_SHAPE_DESC(), SCH_SHEET_DESC::SCH_SHEET_DESC(), SCH_SYMBOL_DESC::SCH_SYMBOL_DESC(), SCH_TABLE_DESC::SCH_TABLE_DESC(), SCH_TABLECELL_DESC::SCH_TABLECELL_DESC(), SCH_TEXT_DESC::SCH_TEXT_DESC(), SCH_TEXTBOX_DESC::SCH_TEXTBOX_DESC(), TRACK_VIA_DESC::TRACK_VIA_DESC(), and ZONE_DESC::ZONE_DESC().

◆ AddTypeCast()

void PROPERTY_MANAGER::AddTypeCast ( TYPE_CAST_BASE * aCast )

Register a type converter.

Required prior TypeCast() usage.

Parameters

aCast is the type converter to register.

Definition at line 161 of file property_mgr.cpp.

References TYPE_CAST_BASE::BaseHash(), TYPE_CAST_BASE::DerivedHash(), getClass(), and PROPERTY_MANAGER::CLASS_DESC::m_typeCasts.

Referenced by ALIGNED_DIMENSION_DESC::ALIGNED_DIMENSION_DESC(), CENTER_DIMENSION_DESC::CENTER_DIMENSION_DESC(), CLASS_D_DESC::CLASS_D_DESC(), DIMENSION_DESC::DIMENSION_DESC(), FOOTPRINT_DESC::FOOTPRINT_DESC(), LEADER_DIMENSION_DESC::LEADER_DIMENSION_DESC(), ORTHOGONAL_DIMENSION_DESC::ORTHOGONAL_DIMENSION_DESC(), PCB_FIELD_DESC::PCB_FIELD_DESC(), PCB_GROUP_DESC::PCB_GROUP_DESC(), PCB_MARKER_DESC::PCB_MARKER_DESC(), PCB_SHAPE_DESC::PCB_SHAPE_DESC(), PCB_TABLE_DESC::PCB_TABLE_DESC(), PCB_TABLECELL_DESC::PCB_TABLECELL_DESC(), PCB_TEXT_DESC::PCB_TEXT_DESC(), PCB_TEXTBOX_DESC::PCB_TEXTBOX_DESC(), PCB_TUNING_PATTERN_DESC::PCB_TUNING_PATTERN_DESC(), RADIAL_DIMENSION_DESC::RADIAL_DIMENSION_DESC(), SCH_DIRECTIVE_LABEL_DESC::SCH_DIRECTIVE_LABEL_DESC(), SCH_FIELD_DESC::SCH_FIELD_DESC(), SCH_GROUP_DESC::SCH_GROUP_DESC(), SCH_LABEL_DESC::SCH_LABEL_DESC(), SCH_PIN_DESC::SCH_PIN_DESC(), SCH_RULE_AREA_DESC::SCH_RULE_AREA_DESC(), SCH_SHAPE_DESC::SCH_SHAPE_DESC(), SCH_SHEET_PIN_DESC::SCH_SHEET_PIN_DESC(), SCH_TABLE_DESC::SCH_TABLE_DESC(), SCH_TABLECELL_DESC::SCH_TABLECELL_DESC(), SCH_TEXT_DESC::SCH_TEXT_DESC(), and SCH_TEXTBOX_DESC::SCH_TEXTBOX_DESC().

◆ GetAllClasses()

PROPERTY_MANAGER::CLASSES_INFO PROPERTY_MANAGER::GetAllClasses ( )

Definition at line 383 of file property_mgr.cpp.

References info, m_classes, and m_classNames.

Referenced by PCBEXPR_UCODE::CreateVarRef(), and PANEL_SETUP_RULES::onScintillaCharAdded().

◆ getClass()

PROPERTY_MANAGER::CLASS_DESC & PROPERTY_MANAGER::getClass ( TYPE_ID aTypeId )

private

Definition at line 276 of file property_mgr.cpp.

References m_classes.

Referenced by AddProperty(), AddTypeCast(), InheritsAfter(), IsAvailableFor(), IsWriteableFor(), Mask(), OverrideAvailability(), OverrideWriteability(), PropertyChanged(), and ReplaceProperty().

◆ GetDisplayOrder()

const std::map< PROPERTY_BASE *, int > & PROPERTY_MANAGER::GetDisplayOrder ( TYPE_ID aType ) const

Definition at line 82 of file property_mgr.cpp.

References EMPTY_PROP_DISPLAY_ORDER, m_classes, m_dirty, PROPERTY_MANAGER(), and Rebuild().

Referenced by PROPERTIES_PANEL::rebuildProperties().

◆ GetGroupDisplayOrder()

const std::vector< wxString > & PROPERTY_MANAGER::GetGroupDisplayOrder ( TYPE_ID aType ) const

Definition at line 96 of file property_mgr.cpp.

References EMPTY_GROUP_DISPLAY_ORDER, m_classes, m_dirty, PROPERTY_MANAGER(), and Rebuild().

Referenced by PROPERTIES_PANEL::rebuildProperties().

◆ GetProperties()

const std::vector< PROPERTY_BASE * > & PROPERTY_MANAGER::GetProperties ( TYPE_ID aType ) const

Return all properties for a specific type.

Parameters

aType is the type identifier (obtained using TYPE_HASH()).

Returns: Vector storing all properties of the requested type.

Definition at line 68 of file property_mgr.cpp.

References EMPTY_PROP_LIST, m_classes, m_dirty, PROPERTY_MANAGER(), and Rebuild().

Referenced by PANEL_SETUP_RULES::onScintillaCharAdded(), and PROPERTIES_PANEL::rebuildProperties().

◆ GetProperty()

PROPERTY_BASE * PROPERTY_MANAGER::GetProperty	(	TYPE_ID	aType,
		const wxString &	aProperty ) const

Return a property for a specific type.

Parameters

aType	is the type identifier (obtained using TYPE_HASH()).
aProperty	is the property name used during class registration.

Returns: Requested property or null pointer if requested property does not exist.

Definition at line 46 of file property_mgr.cpp.

References PROPERTY_MANAGER::CLASS_DESC::m_allProperties, m_classes, m_dirty, PROPERTY_BASE::Name(), PROPERTY_MANAGER(), and Rebuild().

Referenced by BOOST_AUTO_TEST_CASE(), PCBEXPR_UCODE::CreateVarRef(), PROPERTIES_PANEL::extractValueAndWritability(), INSPECTABLE::Get(), PROPERTIES_PANEL::rebuildProperties(), and INSPECTABLE::Set().

◆ InheritsAfter()

void PROPERTY_MANAGER::InheritsAfter	(	TYPE_ID	aDerived,
		TYPE_ID	aBase )

Declare an inheritance relationship between types.

Parameters

aBase	is the base type identifier (obtained using TYPE_HASH()).
aDerived	is the derived type identifier (obtained using TYPE_HASH()).

Definition at line 171 of file property_mgr.cpp.

References getClass(), PROPERTY_MANAGER::CLASS_DESC::m_bases, m_dirty, and PROPERTY_MANAGER::CLASS_DESC::m_typeCasts.

Referenced by ALIGNED_DIMENSION_DESC::ALIGNED_DIMENSION_DESC(), BOARD_CONNECTED_ITEM_DESC::BOARD_CONNECTED_ITEM_DESC(), BOARD_ITEM_DESC::BOARD_ITEM_DESC(), CENTER_DIMENSION_DESC::CENTER_DIMENSION_DESC(), CLASS_B_DESC::CLASS_B_DESC(), CLASS_D_DESC::CLASS_D_DESC(), DIMENSION_DESC::DIMENSION_DESC(), FOOTPRINT_DESC::FOOTPRINT_DESC(), LEADER_DIMENSION_DESC::LEADER_DIMENSION_DESC(), ORTHOGONAL_DIMENSION_DESC::ORTHOGONAL_DIMENSION_DESC(), PAD_DESC::PAD_DESC(), PCB_FIELD_DESC::PCB_FIELD_DESC(), PCB_GROUP_DESC::PCB_GROUP_DESC(), PCB_MARKER_DESC::PCB_MARKER_DESC(), PCB_POINT_DESC::PCB_POINT_DESC(), PCB_REFERENCE_IMAGE_DESC::PCB_REFERENCE_IMAGE_DESC(), PCB_SHAPE_DESC::PCB_SHAPE_DESC(), PCB_TABLE_DESC::PCB_TABLE_DESC(), PCB_TABLECELL_DESC::PCB_TABLECELL_DESC(), PCB_TARGET_DESC::PCB_TARGET_DESC(), PCB_TEXT_DESC::PCB_TEXT_DESC(), PCB_TEXTBOX_DESC::PCB_TEXTBOX_DESC(), PCB_TUNING_PATTERN_DESC::PCB_TUNING_PATTERN_DESC(), RADIAL_DIMENSION_DESC::RADIAL_DIMENSION_DESC(), SCH_BITMAP_DESC::SCH_BITMAP_DESC(), SCH_BUS_ENTRY_DESC::SCH_BUS_ENTRY_DESC(), SCH_DIRECTIVE_LABEL_DESC::SCH_DIRECTIVE_LABEL_DESC(), SCH_FIELD_DESC::SCH_FIELD_DESC(), SCH_GROUP_DESC::SCH_GROUP_DESC(), SCH_ITEM_DESC::SCH_ITEM_DESC(), SCH_JUNCTION_DESC::SCH_JUNCTION_DESC(), SCH_LABEL_DESC::SCH_LABEL_DESC(), SCH_LINE_DESC::SCH_LINE_DESC(), SCH_PIN_DESC::SCH_PIN_DESC(), SCH_RULE_AREA_DESC::SCH_RULE_AREA_DESC(), SCH_SHAPE_DESC::SCH_SHAPE_DESC(), SCH_SHEET_DESC::SCH_SHEET_DESC(), SCH_SHEET_PIN_DESC::SCH_SHEET_PIN_DESC(), SCH_SYMBOL_DESC::SCH_SYMBOL_DESC(), SCH_TABLE_DESC::SCH_TABLE_DESC(), SCH_TABLECELL_DESC::SCH_TABLECELL_DESC(), SCH_TEXT_DESC::SCH_TEXT_DESC(), SCH_TEXTBOX_DESC::SCH_TEXTBOX_DESC(), TRACK_VIA_DESC::TRACK_VIA_DESC(), and ZONE_DESC::ZONE_DESC().

◆ Instance()

static PROPERTY_MANAGER & PROPERTY_MANAGER::Instance ( )

inlinestatic

Definition at line 76 of file property_mgr.h.

References PROPERTY_MANAGER().

Referenced by ALIGNED_DIMENSION_DESC::ALIGNED_DIMENSION_DESC(), BOARD_CONNECTED_ITEM_DESC::BOARD_CONNECTED_ITEM_DESC(), BOARD_ITEM_DESC::BOARD_ITEM_DESC(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), CENTER_DIMENSION_DESC::CENTER_DIMENSION_DESC(), CLASS_A_DESC::CLASS_A_DESC(), CLASS_B_DESC::CLASS_B_DESC(), CLASS_C_DESC::CLASS_C_DESC(), CLASS_D_DESC::CLASS_D_DESC(), CLASS_E_DESC::CLASS_E_DESC(), PCBEXPR_UCODE::CreateVarRef(), DIMENSION_DESC::DIMENSION_DESC(), EDA_ITEM_DESC::EDA_ITEM_DESC(), EDA_SHAPE_DESC::EDA_SHAPE_DESC(), EDA_TEXT_DESC::EDA_TEXT_DESC(), PROPERTIES_PANEL::extractValueAndWritability(), FOOTPRINT_DESC::FOOTPRINT_DESC(), GENERATOR_TOOL::GENERATOR_TOOL(), INSPECTABLE::Get(), INSPECTABLE::Get(), LEADER_DIMENSION_DESC::LEADER_DIMENSION_DESC(), main(), main(), PANEL_SETUP_RULES::onScintillaCharAdded(), ORTHOGONAL_DIMENSION_DESC::ORTHOGONAL_DIMENSION_DESC(), PAD_DESC::PAD_DESC(), PCB_FIELD_DESC::PCB_FIELD_DESC(), PCB_GROUP_DESC::PCB_GROUP_DESC(), PCB_MARKER_DESC::PCB_MARKER_DESC(), PCB_POINT_DESC::PCB_POINT_DESC(), PCB_REFERENCE_IMAGE_DESC::PCB_REFERENCE_IMAGE_DESC(), PCB_SHAPE_DESC::PCB_SHAPE_DESC(), PCB_TABLE_DESC::PCB_TABLE_DESC(), PCB_TABLECELL_DESC::PCB_TABLECELL_DESC(), PCB_TARGET_DESC::PCB_TARGET_DESC(), PCB_TEXT_DESC::PCB_TEXT_DESC(), PCB_TEXTBOX_DESC::PCB_TEXTBOX_DESC(), PCB_TUNING_PATTERN_DESC::PCB_TUNING_PATTERN_DESC(), PROPERTY_COMMIT_HANDLER::PROPERTY_COMMIT_HANDLER(), RADIAL_DIMENSION_DESC::RADIAL_DIMENSION_DESC(), PROPERTIES_PANEL::rebuildProperties(), SCH_BITMAP_DESC::SCH_BITMAP_DESC(), SCH_BUS_ENTRY_DESC::SCH_BUS_ENTRY_DESC(), SCH_DIRECTIVE_LABEL_DESC::SCH_DIRECTIVE_LABEL_DESC(), SCH_FIELD_DESC::SCH_FIELD_DESC(), SCH_GROUP_DESC::SCH_GROUP_DESC(), SCH_ITEM_DESC::SCH_ITEM_DESC(), SCH_JUNCTION_DESC::SCH_JUNCTION_DESC(), SCH_LABEL_DESC::SCH_LABEL_DESC(), SCH_LINE_DESC::SCH_LINE_DESC(), SCH_PIN_DESC::SCH_PIN_DESC(), SCH_RULE_AREA_DESC::SCH_RULE_AREA_DESC(), SCH_SHAPE_DESC::SCH_SHAPE_DESC(), SCH_SHEET_DESC::SCH_SHEET_DESC(), SCH_SHEET_PIN_DESC::SCH_SHEET_PIN_DESC(), SCH_SYMBOL_DESC::SCH_SYMBOL_DESC(), SCH_TABLE_DESC::SCH_TABLE_DESC(), SCH_TABLECELL_DESC::SCH_TABLECELL_DESC(), SCH_TEXT_DESC::SCH_TEXT_DESC(), SCH_TEXTBOX_DESC::SCH_TEXTBOX_DESC(), SCHEMATIC::SCHEMATIC(), INSPECTABLE::Set(), INSPECTABLE::Set(), INSPECTABLE::Set(), INSPECTABLE::Set(), TRACK_VIA_DESC::TRACK_VIA_DESC(), ZONE_DESC::ZONE_DESC(), PROPERTY_COMMIT_HANDLER::~PROPERTY_COMMIT_HANDLER(), and SCHEMATIC::~SCHEMATIC().

◆ IsAvailableFor()

bool PROPERTY_MANAGER::IsAvailableFor	(	TYPE_ID	aItemClass,
		PROPERTY_BASE *	aProp,
		INSPECTABLE *	aItem )

Checks overriden availability and original availability of a property, returns false if the property is unavailable in either case.

TODO: This isn't the cleanest API, consider how to merge with PROPERTY_BASE::Available

Definition at line 216 of file property_mgr.cpp.

References PROPERTY_BASE::Available(), PROPERTY_BASE::BaseHash(), getClass(), PROPERTY_MANAGER::CLASS_DESC::m_availabilityOverrides, and PROPERTY_BASE::Name().

Referenced by PROPERTIES_PANEL::extractValueAndWritability().

◆ IsOfType()

bool PROPERTY_MANAGER::IsOfType	(	TYPE_ID	aDerived,
		TYPE_ID	aBase ) const

Return true if aDerived is inherited from aBase.

Definition at line 248 of file property_mgr.cpp.

References IsOfType(), and m_classes.

Referenced by PCBEXPR_UCODE::CreateVarRef(), IsOfType(), and TypeCast().

◆ IsWriteableFor()

bool PROPERTY_MANAGER::IsWriteableFor	(	TYPE_ID	aItemClass,
		PROPERTY_BASE *	aProp,
		INSPECTABLE *	aItem )

Checks overriden availability and original availability of a property, returns false if the property is unavailable in either case.

TODO: This isn't the cleanest API, consider how to merge with PROPERTY_BASE::Writeable

Definition at line 232 of file property_mgr.cpp.

References PROPERTY_BASE::BaseHash(), getClass(), PROPERTY_MANAGER::CLASS_DESC::m_writeabilityOverrides, PROPERTY_BASE::Name(), and PROPERTY_BASE::Writeable().

Referenced by PROPERTIES_PANEL::extractValueAndWritability().

◆ Mask()

void PROPERTY_MANAGER::Mask	(	TYPE_ID	aDerived,
		TYPE_ID	aBase,
		const wxString &	aName )

Sets a base class property as masked in a derived class.

Masked properties are hidden from the list of editable properties for this class.

Parameters

aDerived	is the type to apply the mask for.
aBase	is the type that aName belongs to.
aName	is the name of a property on the base class.

Definition at line 184 of file property_mgr.cpp.

References getClass(), m_dirty, and PROPERTY_MANAGER::CLASS_DESC::m_maskedBaseProperties.

Referenced by DIMENSION_DESC::DIMENSION_DESC(), PAD_DESC::PAD_DESC(), PCB_FIELD_DESC::PCB_FIELD_DESC(), PCB_GROUP_DESC::PCB_GROUP_DESC(), PCB_MARKER_DESC::PCB_MARKER_DESC(), PCB_SHAPE_DESC::PCB_SHAPE_DESC(), PCB_TABLECELL_DESC::PCB_TABLECELL_DESC(), PCB_TEXT_DESC::PCB_TEXT_DESC(), PCB_TEXTBOX_DESC::PCB_TEXTBOX_DESC(), SCH_DIRECTIVE_LABEL_DESC::SCH_DIRECTIVE_LABEL_DESC(), SCH_FIELD_DESC::SCH_FIELD_DESC(), SCH_GROUP_DESC::SCH_GROUP_DESC(), SCH_LABEL_DESC::SCH_LABEL_DESC(), SCH_TABLECELL_DESC::SCH_TABLECELL_DESC(), SCH_TEXT_DESC::SCH_TEXT_DESC(), SCH_TEXTBOX_DESC::SCH_TEXTBOX_DESC(), and TRACK_VIA_DESC::TRACK_VIA_DESC().

◆ OverrideAvailability()

void PROPERTY_MANAGER::OverrideAvailability	(	TYPE_ID	aDerived,
		TYPE_ID	aBase,
		const wxString &	aName,
		std::function< bool(INSPECTABLE *)>	aFunc )

Sets an override availability functor for a base class property of a given derived class.

Parameters

aDerived	is the type to apply the mask for.
aBase	is the type that aName belongs to.
aName	is the name of a property on the base class.
aFunc	is the new availability functor to apply.

Definition at line 194 of file property_mgr.cpp.

References getClass(), PROPERTY_MANAGER::CLASS_DESC::m_availabilityOverrides, and m_dirty.

Referenced by ALIGNED_DIMENSION_DESC::ALIGNED_DIMENSION_DESC(), CENTER_DIMENSION_DESC::CENTER_DIMENSION_DESC(), LEADER_DIMENSION_DESC::LEADER_DIMENSION_DESC(), ORTHOGONAL_DIMENSION_DESC::ORTHOGONAL_DIMENSION_DESC(), PAD_DESC::PAD_DESC(), PCB_SHAPE_DESC::PCB_SHAPE_DESC(), PCB_TEXT_DESC::PCB_TEXT_DESC(), RADIAL_DIMENSION_DESC::RADIAL_DIMENSION_DESC(), SCH_FIELD_DESC::SCH_FIELD_DESC(), SCH_SHAPE_DESC::SCH_SHAPE_DESC(), and ZONE_DESC::ZONE_DESC().

◆ OverrideWriteability()

void PROPERTY_MANAGER::OverrideWriteability	(	TYPE_ID	aDerived,
		TYPE_ID	aBase,
		const wxString &	aName,
		std::function< bool(INSPECTABLE *)>	aFunc )

Sets an override writeability functor for a base class property of a given derived class.

Parameters

aDerived	is the type to apply the mask for.
aBase	is the type that aName belongs to.
aName	is the name of a property on the base class.
aFunc	is the new availability functor to apply.

Definition at line 205 of file property_mgr.cpp.

References getClass(), m_dirty, and PROPERTY_MANAGER::CLASS_DESC::m_writeabilityOverrides.

Referenced by SCH_FIELD_DESC::SCH_FIELD_DESC(), and SCH_SHAPE_DESC::SCH_SHAPE_DESC().

◆ PropertyChanged()

void PROPERTY_MANAGER::PropertyChanged	(	INSPECTABLE *	aObject,
		PROPERTY_BASE *	aProperty )

Callback to alert the notification system that a property has changed.

Parameters

aObject	is the object whose property just changed
aProperty	is the property that changed

Definition at line 404 of file property_mgr.cpp.

References getClass(), PROPERTY_MANAGER::CLASS_DESC::m_bases, PROPERTY_MANAGER::CLASS_DESC::m_id, m_listeners, m_managedCommit, and TYPE_HASH.

Referenced by INSPECTABLE::Set(), INSPECTABLE::Set(), INSPECTABLE::Set(), and INSPECTABLE::Set().

◆ Rebuild()

void PROPERTY_MANAGER::Rebuild ( )

Rebuild the list of all registered properties.

Needs to be called once before GetProperty()/GetProperties() are used.

Definition at line 267 of file property_mgr.cpp.

References m_classes, and m_dirty.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), GetDisplayOrder(), GetGroupDisplayOrder(), GetProperties(), GetProperty(), main(), and main().

◆ RegisterListener()

void PROPERTY_MANAGER::RegisterListener	(	TYPE_ID	aType,
		PROPERTY_LISTENER	aListenerFunc )

inline

Registers a listener for the given type.

Parameters

aType	is the type to add the listener for
aListenerFunc	will be called every time a property on aType is changed

Definition at line 254 of file property_mgr.h.

References m_listeners.

Referenced by GENERATOR_TOOL::GENERATOR_TOOL(), and SCHEMATIC::SCHEMATIC().

◆ RegisterType()

void PROPERTY_MANAGER::RegisterType	(	TYPE_ID	aType,
		const wxString &	aName )

Associate a name with a type.

Build a map to provide faster type look-up.

Parameters

aType	is the type identifier (obtained using TYPE_HASH()).
aName	is the type name.

Definition at line 39 of file property_mgr.cpp.

References m_classNames.

◆ ReplaceProperty()

PROPERTY_BASE & PROPERTY_MANAGER::ReplaceProperty	(	size_t	aBase,
		const wxString &	aName,
		PROPERTY_BASE *	aNew,
		const wxString &	aGroup = wxEmptyString )

Replace an existing property for a specific type.

It is used to modify a property that has been inherited from a base class. This method is used instead of AddProperty().

Parameters

aBase	is the base class type the delivers the original property.
aName	is the name of the replaced property.
aNew	is the property replacing the inherited one.
aGroup	is the group to set for the replaced property.

Definition at line 152 of file property_mgr.cpp.

References AddProperty(), getClass(), PROPERTY_MANAGER::CLASS_DESC::m_replaced, and PROPERTY_BASE::OwnerHash().

Referenced by BOARD_CONNECTED_ITEM_DESC::BOARD_CONNECTED_ITEM_DESC(), CLASS_D_DESC::CLASS_D_DESC(), CLASS_E_DESC::CLASS_E_DESC(), FOOTPRINT_DESC::FOOTPRINT_DESC(), PCB_REFERENCE_IMAGE_DESC::PCB_REFERENCE_IMAGE_DESC(), PCB_SHAPE_DESC::PCB_SHAPE_DESC(), PCB_TUNING_PATTERN_DESC::PCB_TUNING_PATTERN_DESC(), SCH_FIELD_DESC::SCH_FIELD_DESC(), TRACK_VIA_DESC::TRACK_VIA_DESC(), and ZONE_DESC::ZONE_DESC().

◆ TypeCast() [1/2]

const void * PROPERTY_MANAGER::TypeCast	(	const void *	aSource,
		TYPE_ID	aBase,
		TYPE_ID	aTarget ) const

Cast a type to another type.

Used for correct type-casting of types with multi-inheritance. Requires registration of an appropriate converter (AddTypeCast).

Parameters

aSource	is a pointer to the casted object.
aBase	is aSource type identifier (obtained using TYPE_HASH()).
aTarget	is the desired type identifier (obtained using TYPE_HASH()).

Returns: Properly casted pointer of aTarget type. *

See also: AddTypeCast

Definition at line 110 of file property_mgr.cpp.

References IsOfType(), and m_classes.

Referenced by INSPECTABLE::Get(), INSPECTABLE::Get(), INSPECTABLE::Set(), INSPECTABLE::Set(), INSPECTABLE::Set(), INSPECTABLE::Set(), and TypeCast().

◆ TypeCast() [2/2]

void * PROPERTY_MANAGER::TypeCast	(	void *	aSource,
		TYPE_ID	aBase,
		TYPE_ID	aTarget ) const

inline

Definition at line 126 of file property_mgr.h.

References TypeCast().

◆ UnregisterListeners()

void PROPERTY_MANAGER::UnregisterListeners ( TYPE_ID aType )

inline

Definition at line 259 of file property_mgr.h.

References m_listeners.

Referenced by SCHEMATIC::~SCHEMATIC().

Friends And Related Symbol Documentation

◆ PROPERTY_COMMIT_HANDLER

friend class PROPERTY_COMMIT_HANDLER

friend

Structure holding type meta-data.

Definition at line 271 of file property_mgr.h.

References PROPERTY_COMMIT_HANDLER.

Referenced by PROPERTY_COMMIT_HANDLER.

Member Data Documentation

◆ m_classes

std::unordered_map<TYPE_ID, CLASS_DESC> PROPERTY_MANAGER::m_classes

private

Definition at line 339 of file property_mgr.h.

Referenced by GetAllClasses(), getClass(), GetDisplayOrder(), GetGroupDisplayOrder(), GetProperties(), GetProperty(), IsOfType(), Rebuild(), and TypeCast().

◆ m_classNames

std::unordered_map<TYPE_ID, wxString> PROPERTY_MANAGER::m_classNames

private

Map of all available types.

Definition at line 336 of file property_mgr.h.

Referenced by GetAllClasses(), and RegisterType().

◆ m_dirty

bool PROPERTY_MANAGER::m_dirty

private

Flag indicating that the list of properties needs to be rebuild (RebuildProperties())

Definition at line 342 of file property_mgr.h.

Referenced by AddProperty(), GetDisplayOrder(), GetGroupDisplayOrder(), GetProperties(), GetProperty(), InheritsAfter(), Mask(), OverrideAvailability(), OverrideWriteability(), PROPERTY_MANAGER(), and Rebuild().

◆ m_listeners

std::map<TYPE_ID, std::vector<PROPERTY_LISTENER> > PROPERTY_MANAGER::m_listeners

private

Definition at line 344 of file property_mgr.h.

Referenced by PropertyChanged(), RegisterListener(), and UnregisterListeners().

◆ m_managedCommit

COMMIT* PROPERTY_MANAGER::m_managedCommit

private

Definition at line 346 of file property_mgr.h.

Referenced by PROPERTY_COMMIT_HANDLER::PROPERTY_COMMIT_HANDLER(), PROPERTY_MANAGER(), PropertyChanged(), and PROPERTY_COMMIT_HANDLER::~PROPERTY_COMMIT_HANDLER().

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

Classes

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ CLASSES_INFO

Constructor & Destructor Documentation

◆ PROPERTY_MANAGER()

Member Function Documentation

◆ AddProperty()

◆ AddTypeCast()

◆ GetAllClasses()

◆ getClass()

◆ GetDisplayOrder()

◆ GetGroupDisplayOrder()

◆ GetProperties()

◆ GetProperty()

◆ InheritsAfter()

◆ Instance()

◆ IsAvailableFor()

◆ IsOfType()

◆ IsWriteableFor()

◆ Mask()

◆ OverrideAvailability()

◆ OverrideWriteability()

◆ PropertyChanged()

◆ Rebuild()

◆ RegisterListener()

◆ RegisterType()

◆ ReplaceProperty()

◆ TypeCast() [1/2]

◆ TypeCast() [2/2]

◆ UnregisterListeners()

Friends And Related Symbol Documentation

◆ PROPERTY_COMMIT_HANDLER

Member Data Documentation

◆ m_classes

◆ m_classNames

◆ m_dirty

◆ m_listeners

◆ m_managedCommit