Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitk::ModalityProperty Class Reference

Enumeration property for known imaging modalities. More...

#include <mitkModalityProperty.h>

Inheritance diagram for mitk::ModalityProperty:
Collaboration diagram for mitk::ModalityProperty:

Public Member Functions

 mitkClassMacro (ModalityProperty, EnumerationProperty)
 
Pointer Clone () const
 
 mitkNewMacro1Param (ModalityProperty, const IdType &)
 
 mitkNewMacro1Param (ModalityProperty, const std::string &)
 
BaseProperty & operator= (const BaseProperty &property)
 Assign a property value to this instance. More...
 
- Public Member Functions inherited from mitk::EnumerationProperty
 mitkClassMacro (EnumerationProperty, BaseProperty)
 
Pointer Clone () const
 
virtual bool AddEnum (const std::string &name, const IdType &id)
 Add an enumeration value. More...
 
virtual bool SetValue (const std::string &name)
 Set the current value of the enumeration by name. More...
 
virtual bool SetValue (const IdType &id)
 Set the current value of the enumeration by id. More...
 
virtual IdType GetValueAsId () const
 Get the id of the currently selected enumeration value. More...
 
std::string GetValueAsString () const override
 Get the name of the currently selected enumeration value. More...
 
virtual void Clear ()
 Remove all enumeration values and reset the current selection. More...
 
virtual EnumIdsContainerType::size_type Size () const
 Get the number of defined enumeration values. More...
 
virtual EnumConstIterator Begin () const
 Get an iterator to the first enumeration value. More...
 
virtual EnumConstIterator End () const
 Get an iterator past the last enumeration value. More...
 
virtual std::string GetEnumString (const IdType &id) const
 Get the name string for a given enumeration id. More...
 
virtual IdType GetEnumId (const std::string &name) const
 Get the id for a given enumeration name. More...
 
virtual bool IsValidEnumerationValue (const IdType &id) const
 Check whether a given id corresponds to a valid enumeration value. More...
 
virtual bool IsValidEnumerationValue (const std::string &name) const
 Check whether a given name corresponds to a valid enumeration value. More...
 
const EnumIdsContainerType & GetEnumIds () const
 Get a const reference to the id-to-name map. More...
 
const EnumStringsContainerType & GetEnumStrings () const
 Get a const reference to the name-to-id map. More...
 
EnumIdsContainerType & GetEnumIds ()
 Get a mutable reference to the id-to-name map. More...
 
EnumStringsContainerType & GetEnumStrings ()
 Get a mutable reference to the name-to-id map. More...
 
bool ToJSON (nlohmann::json &j) const override
 Serialize the current enumeration value to JSON. More...
 
bool FromJSON (const nlohmann::json &j) override
 Deserialize the enumeration value from JSON. More...
 
EnumerationProperty & operator= (const EnumerationProperty &)=delete
 
BaseProperty & operator= (const BaseProperty &property)
 Assign a property value to this instance. More...
 
- Public Member Functions inherited from mitk::BaseProperty
 mitkClassMacroItkParent (BaseProperty, itk::Object)
 
Pointer Clone () const
 
bool operator== (const BaseProperty &property) const
 Compare two properties for equality. More...
 
BaseProperty & operator= (const BaseProperty &property)
 Assign a property value to this instance. More...
 
bool AssignProperty (const BaseProperty &property)
 Assign a property value to this instance and report success. More...
 

Static Public Member Functions

static Pointer New ()
 
- Static Public Member Functions inherited from mitk::EnumerationProperty
static Pointer New ()
 

Protected Member Functions

 ModalityProperty ()
 Default constructor. Populates the enumeration with standard modality types. More...
 
 ModalityProperty (const ModalityProperty &other)
 Copy constructor. More...
 
 ModalityProperty (const IdType &value)
 Construct with a modality id. More...
 
 ModalityProperty (const std::string &value)
 Construct with a modality name string. More...
 
 ~ModalityProperty () override
 
virtual void AddEnumerationTypes ()
 Populates the enumeration with standard DICOM modality types (CT, MR, US, etc.). More...
 
 mitkCloneMacro (ModalityProperty)
 
- Protected Member Functions inherited from mitk::EnumerationProperty
 EnumerationProperty ()
 
 EnumerationProperty (const EnumerationProperty &)
 
bool IsEqual (const BaseProperty &property) const override
 
bool Assign (const BaseProperty &property) override
 
 mitkCloneMacro (Self)
 
- Protected Member Functions inherited from mitk::BaseProperty
 BaseProperty ()
 
 BaseProperty (const BaseProperty &other)
 
 ~BaseProperty () override
 

Additional Inherited Members

- Public Types inherited from mitk::EnumerationProperty
typedef unsigned int IdType
 Unsigned integer type used as unique enumeration value identifier. More...
 
typedef std::map< IdType, std::string > EnumIdsContainerType
 Map type storing id-to-name mappings. More...
 
typedef std::map< std::string, IdType > EnumStringsContainerType
 Map type storing name-to-id mappings. More...
 
typedef EnumIdsContainerType::const_iterator EnumConstIterator
 Const iterator type for iterating over enumeration values. More...
 
- Static Public Attributes inherited from mitk::BaseProperty
static const std::string VALUE_CANNOT_BE_CONVERTED_TO_STRING
 Default return value for properties that cannot be converted to a string. More...
 

Detailed Description

Enumeration property for known imaging modalities.

Pre-populates the enumeration with standard medical imaging modalities (e.g., CT, MR, US, XA, etc.) in its constructor. Can be initialized by modality name or by id.

See also
EnumerationProperty
BaseProperty

Definition at line 32 of file mitkModalityProperty.h.

Constructor & Destructor Documentation

◆ ModalityProperty() [1/4]

mitk::ModalityProperty::ModalityProperty ( )
protected

Default constructor. Populates the enumeration with standard modality types.

◆ ModalityProperty() [2/4]

mitk::ModalityProperty::ModalityProperty ( const ModalityProperty &  other)
protected

Copy constructor.

◆ ModalityProperty() [3/4]

mitk::ModalityProperty::ModalityProperty ( const IdType &  value)
protected

Construct with a modality id.

If the given id is not valid, the modality defaults to the first entry (undefined).

Parameters
valueThe enumeration id of the modality.

◆ ModalityProperty() [4/4]

mitk::ModalityProperty::ModalityProperty ( const std::string &  value)
protected

Construct with a modality name string.

If the given string is not a valid modality name, the modality defaults to "undefined".

Parameters
valueThe modality name string (e.g. "CT", "MR", "US").

◆ ~ModalityProperty()

mitk::ModalityProperty::~ModalityProperty ( )
overrideprotected

Member Function Documentation

◆ AddEnumerationTypes()

virtual void mitk::ModalityProperty::AddEnumerationTypes ( )
protectedvirtual

Populates the enumeration with standard DICOM modality types (CT, MR, US, etc.).

◆ Clone()

Pointer mitk::ModalityProperty::Clone ( ) const

◆ mitkClassMacro()

mitk::ModalityProperty::mitkClassMacro ( ModalityProperty  ,
EnumerationProperty   
)

◆ mitkCloneMacro()

mitk::ModalityProperty::mitkCloneMacro ( ModalityProperty  )
protected

◆ mitkNewMacro1Param() [1/2]

mitk::ModalityProperty::mitkNewMacro1Param ( ModalityProperty  ,
const IdType &   
)

◆ mitkNewMacro1Param() [2/2]

mitk::ModalityProperty::mitkNewMacro1Param ( ModalityProperty  ,
const std::string &   
)

◆ New()

static Pointer mitk::ModalityProperty::New ( )
static

◆ operator=()

BaseProperty& mitk::BaseProperty::operator=

Assign a property value to this instance.

Performs a polymorphic assignment from the given property. The assignment succeeds only if the source and target properties are of the same type. The subclass-specific Assign() method is called to perform the actual value copy.

Subclasses must implement Assign(const BaseProperty&) and call the superclass Assign method for proper handling. The copy assignment operator of the subclass should be disabled and the base class operator should be made visible using "using" statements.

Parameters
[in]propertyThe property whose value should be assigned to this instance.
Returns
A reference to this property.
See also
AssignProperty
Assign

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