MeVisLab Toolbox Reference
ml::DicomValueComboBoxSelectorTagInterface Class Reference

#include <mlDicomValueComboBoxSelectorTagInterface.h>

Inheritance diagram for ml::DicomValueComboBoxSelectorTagInterface:
ml::DicomModifyFieldAddOnBase ml::DicomModifyList ml::FieldAddOnBase ml::Base

Public Types

enum  { NumInheritModeStrings = 4 }
 Number of ways how a tag value can be inherited form input. More...
enum  InheritMode { InheritValidOnly =0 , InheritValidOtherwiseDefault , InheritAny , DoNotInherit }
 Available inherit and modify modes. More...
Public Types inherited from ml::Base
enum  PersistenceInterface { PersistenceByString , PersistenceByTreeNode , PersistenceByStream }
 This enum describes the different persistence interfaces available. More...
Public Types inherited from ml::FieldAddOnBase
enum  FieldChangeState { NoChange = 0 , StatusOnlyChange , RecalculationRequired }
 Describes the type of a field changes detected in handleFieldChanges(Field *field). More...

Public Member Functions

 DicomValueComboBoxSelectorTagInterface (Module &modRef, const std::string &fieldName, const char *const *selectableValues, size_t numSelectableValues, size_t defaultValueIndex=0, InheritMode inheritModeDefault=InheritValidOnly)
void addFields () override
 Add fields to field container of module.
void handleFieldActivationChanges () override
 Handle class changes according to Module::activateAttachments.
FieldAddOnBase::FieldChangeState handleFieldChanges (Field *field) override
 Handle field notifications according to Module::activateAttachments with a return of field change state.
virtual void inheritValues (DCMTree::Const_TreePtr dcmTree, const std::string &inValue, const std::string *fallBack=nullptr)
std::string applyModifications (DCMTree::TreePtr dcmTree, const FieldContainer *treeInfos=nullptr) override
virtual std::string checkConsistency (const std::string *errorFieldName=nullptr) const
BoolFieldgetCheckConsistencyFld () const
 See _checkConsistencyFld.
EnumFieldgetInheritModeFld () const
 See _inheritModeFld.
StringFieldgetSelectableValuesFld () const
 See _selectableValuesFld.
StringFieldgetValueFld () const
 See _valueFld.
Public Member Functions inherited from ml::DicomModifyFieldAddOnBase
 DicomModifyFieldAddOnBase (FieldContainer &fieldContainerRef, size_t numInstances=1, bool createInputModifyTagsPluginBaseConnectorField=false, bool createOutputModifyTagsPluginBaseConnectorField=false)
 ~DicomModifyFieldAddOnBase () override
 Destructor resetting connector fields if they exist.
size_t getNumInstances () const
 Returns the number of instances to be created by derived fields.
virtual void inheritValues (DCMTree::Const_TreePtr)
 Can be used to implement the copy of tag values from the given dcmTree to the fields.
virtual std::string checkConsistency () const
 Checks for invalid parameters; return textual description on error, or empty string on success.
BaseFieldgetOutputModifierListFld () const
 Provide access to output base field if it was created.
BaseFieldgetInputModifierListFld () const
 Provide access to input base connector field if it was created.
Public Member Functions inherited from ml::DicomModifyList
 DicomModifyList ()
 ~DicomModifyList () override
 Destructor also destroying all of its stored Modifiers.
void addModifier (DicomModifyBase *modifier, bool atEnd=true)
void clear ()
 Makes modifier array empty and deletes all of them.
std::vector< DicomModifyBase * > & getModifierList ()
const std::vector< DicomModifyBase * > & getModifierList () const
 Same as getModifierList() only for constant access.
void setInputPlugin (DicomModifyList *inputPlugin=nullptr)
DicomModifyListgetInputPlugin () const
 Returns the optional plugin to be called by applyModififcations.
Public Member Functions inherited from ml::Base
 Base ()
 Constructor.
virtual ~Base ()
 Destructor.
virtual BasedeepCopy () const
bool isOfAllowedType (const std::vector< const RuntimeType * > &types) const
virtual bool isRefCountedBase () const
 Returns whether the instance is derived from RefCountedBase.
virtual std::string detailString () const
virtual bool implementsPersistence (PersistenceInterface) const
virtual std::string persistentState () const
 Returns a string describing the object's internal state.
virtual void setPersistentState (const std::string &state)
virtual void addStateToTree (TreeNode *) const
 Attaches the object state as children of the given parent node.
virtual void readStateFromTree (TreeNode *)
 Reads the object state from the children of the given parent node.
virtual void writeTo (AbstractPersistenceOutputStream *) const
virtual void readFrom (AbstractPersistenceInputStream *, int)
Public Member Functions inherited from ml::FieldAddOnBase
 FieldAddOnBase (FieldContainer &fieldContainerRef)
 Constructor, setting the reference of the FieldContainer managing the fields.
virtual ~FieldAddOnBase ()
 Destructor.
FieldContainergetFieldContainer ()
 Returns the referenced container.
const FieldContainergetFieldContainer () const
 Returns the referenced container.
std::vector< Field * > & getFields ()
 Return modification access to the list of managed fields, use at own risk!
const std::vector< Field * > & getFields () const
 Return constant access to the list of managed fields!
virtual FieldChangeState getMergedFieldChangeState (FieldChangeState state1, FieldChangeState state2) const
 Returns a FieldChangeState which best represents a merge of the two given states.
virtual bool hasField (Field *field) const
 Returns true if the passed fieldPtr is in _fieldPointers, otherwise false.

Static Public Member Functions

static std::string getComposedString (const char *const *stringSet, const size_t numStrings, const std::string &separator=",")
Static Public Member Functions inherited from ml::DicomModifyFieldAddOnBase
static bool isIn (const std::string &str, const char *const *values, size_t numValues)
 Static helper function which checks whether str is part of the given list of values which has numValues entries.

Static Public Attributes

static const char *const InheritModeStrings [NumInheritModeStrings]
 Possible string values for ways how a tag value can be determined.

Protected Attributes

const std::string _fieldName
 The name of the value field.
const char *const * _selectableValues
 The array of numSelectableValues string values which are allowed in _valueField.
const size_t _numSelectableValues
 The number of values in selectableValuesStr.
const size_t _defaultSelectableValueIndex
 The index of the default value to be used in _valueField.
const InheritMode _inheritModeDefault
 The default index to the default value to be used in _valueField.
BoolField_checkConsistencyFld
 Controls whether the content of _valueFld is checked in checkConsistency or not.
EnumField_inheritModeFld
 Enumerator field controls the way how values for the valueFld may be inherited or adapted.
StringField_selectableValuesFld
 Allowed values for _valueField, composed for use in a MeVisLab ComoboBox field control.
StringField_valueFld
 The value to be managed.

Additional Inherited Members

Protected Member Functions inherited from ml::FieldAddOnBase
void _addFieldPointer (Field *field)

Detailed Description

A complex field interface managing a value selector for combo boxes with a number of predefined values; a checkBox whether the fieldValue shall be checked by the module for validity, an InheritMode which determines in which way the value shall be inherited from the input connection. creates four fields: fieldName+"CheckConsistensy", fieldName+"InheritMode", fieldName+"SelectableValues", and fieldName where fieldName can be selected as comboBox from selectableValues.

Definition at line 27 of file mlDicomValueComboBoxSelectorTagInterface.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Number of ways how a tag value can be inherited form input.

Enumerator
NumInheritModeStrings 

Definition at line 32 of file mlDicomValueComboBoxSelectorTagInterface.h.

◆ InheritMode

Available inherit and modify modes.

Enumerator
InheritValidOnly 
InheritValidOtherwiseDefault 

Inherit only valid values, otherwise drop to the default value.

InheritAny 

Inherit any valid or invalid value, regardless of its validity.

DoNotInherit 

Do not inherit any value at all.

Definition at line 38 of file mlDicomValueComboBoxSelectorTagInterface.h.

Constructor & Destructor Documentation

◆ DicomValueComboBoxSelectorTagInterface()

ml::DicomValueComboBoxSelectorTagInterface::DicomValueComboBoxSelectorTagInterface ( Module & modRef,
const std::string & fieldName,
const char *const * selectableValues,
size_t numSelectableValues,
size_t defaultValueIndex = 0,
InheritMode inheritModeDefault = InheritValidOnly )

Constructor, setting the reference of the module for which the fields shall be managed.

Parameters
modRefThe module into which the fields of the AddIn shall be added.
fieldNameThe (field)name of the field to be managed.
selectableValuesThe list of strings provided as possible selectable values; number must match numValidValues.
numSelectableValuesNumber of values in selectableValues.
defaultValueIndexIndex into selectableValues which shall be used as default.
inheritModeDefaultInheritMode which shall be used as default for the InheritModeField.

References InheritValidOnly.

Member Function Documentation

◆ addFields()

void ml::DicomValueComboBoxSelectorTagInterface::addFields ( )
overridevirtual

Add fields to field container of module.

Reimplemented from ml::DicomModifyFieldAddOnBase.

◆ applyModifications()

std::string ml::DicomValueComboBoxSelectorTagInterface::applyModifications ( DCMTree::TreePtr dcmTree,
const FieldContainer * treeInfos = nullptr )
overridevirtual

See DicomModifyFieldAddOnBase::applyModifications() for documentation; adds field values as tags to dcmTree: this class implements only the default base class call.

Reimplemented from ml::DicomModifyFieldAddOnBase.

◆ checkConsistency()

virtual std::string ml::DicomValueComboBoxSelectorTagInterface::checkConsistency ( const std::string * errorFieldName = nullptr) const
virtual

Checks for invalid parameters; return textual description on error, or empty string on success; if errorFieldName is passed as non-nullptr the it will be used instead of the normal field name in a possibly returned error messages.

◆ getCheckConsistencyFld()

BoolField & ml::DicomValueComboBoxSelectorTagInterface::getCheckConsistencyFld ( ) const
inline

See _checkConsistencyFld.

Definition at line 87 of file mlDicomValueComboBoxSelectorTagInterface.h.

References _checkConsistencyFld.

◆ getComposedString()

std::string ml::DicomValueComboBoxSelectorTagInterface::getComposedString ( const char *const * stringSet,
const size_t numStrings,
const std::string & separator = "," )
static

Mainly internally used static helper function which returns a string composed from all entries of stringSet containing numStrings and separated by separator.

◆ getInheritModeFld()

EnumField & ml::DicomValueComboBoxSelectorTagInterface::getInheritModeFld ( ) const
inline

See _inheritModeFld.

Definition at line 90 of file mlDicomValueComboBoxSelectorTagInterface.h.

References _inheritModeFld.

◆ getSelectableValuesFld()

StringField & ml::DicomValueComboBoxSelectorTagInterface::getSelectableValuesFld ( ) const
inline

See _selectableValuesFld.

Definition at line 93 of file mlDicomValueComboBoxSelectorTagInterface.h.

References _selectableValuesFld.

◆ getValueFld()

StringField & ml::DicomValueComboBoxSelectorTagInterface::getValueFld ( ) const
inline

See _valueFld.

Definition at line 96 of file mlDicomValueComboBoxSelectorTagInterface.h.

References _valueFld.

◆ handleFieldActivationChanges()

void ml::DicomValueComboBoxSelectorTagInterface::handleFieldActivationChanges ( )
overridevirtual

Handle class changes according to Module::activateAttachments.

Reimplemented from ml::DicomModifyFieldAddOnBase.

◆ handleFieldChanges()

FieldAddOnBase::FieldChangeState ml::DicomValueComboBoxSelectorTagInterface::handleFieldChanges ( Field * field)
overridevirtual

Handle field notifications according to Module::activateAttachments with a return of field change state.

Reimplemented from ml::DicomModifyFieldAddOnBase.

◆ inheritValues()

virtual void ml::DicomValueComboBoxSelectorTagInterface::inheritValues ( DCMTree::Const_TreePtr dcmTree,
const std::string & inValue,
const std::string * fallBack = nullptr )
virtual

Implements the call of DicomModifyFieldAddOnBase and passes the unmodified values form the source. If fallback is passed non-nullptr then it is used instead of the field default if that one is needed.

Member Data Documentation

◆ _checkConsistencyFld

BoolField* ml::DicomValueComboBoxSelectorTagInterface::_checkConsistencyFld
protected

Controls whether the content of _valueFld is checked in checkConsistency or not.

Definition at line 123 of file mlDicomValueComboBoxSelectorTagInterface.h.

Referenced by getCheckConsistencyFld().

◆ _defaultSelectableValueIndex

const size_t ml::DicomValueComboBoxSelectorTagInterface::_defaultSelectableValueIndex
protected

The index of the default value to be used in _valueField.

Definition at line 116 of file mlDicomValueComboBoxSelectorTagInterface.h.

◆ _fieldName

const std::string ml::DicomValueComboBoxSelectorTagInterface::_fieldName
protected

The name of the value field.

Definition at line 107 of file mlDicomValueComboBoxSelectorTagInterface.h.

◆ _inheritModeDefault

const InheritMode ml::DicomValueComboBoxSelectorTagInterface::_inheritModeDefault
protected

The default index to the default value to be used in _valueField.

Definition at line 119 of file mlDicomValueComboBoxSelectorTagInterface.h.

◆ _inheritModeFld

EnumField* ml::DicomValueComboBoxSelectorTagInterface::_inheritModeFld
protected

Enumerator field controls the way how values for the valueFld may be inherited or adapted.

Definition at line 126 of file mlDicomValueComboBoxSelectorTagInterface.h.

Referenced by getInheritModeFld().

◆ _numSelectableValues

const size_t ml::DicomValueComboBoxSelectorTagInterface::_numSelectableValues
protected

The number of values in selectableValuesStr.

Definition at line 113 of file mlDicomValueComboBoxSelectorTagInterface.h.

◆ _selectableValues

const char* const* ml::DicomValueComboBoxSelectorTagInterface::_selectableValues
protected

The array of numSelectableValues string values which are allowed in _valueField.

Definition at line 110 of file mlDicomValueComboBoxSelectorTagInterface.h.

◆ _selectableValuesFld

StringField* ml::DicomValueComboBoxSelectorTagInterface::_selectableValuesFld
protected

Allowed values for _valueField, composed for use in a MeVisLab ComoboBox field control.

Definition at line 129 of file mlDicomValueComboBoxSelectorTagInterface.h.

Referenced by getSelectableValuesFld().

◆ _valueFld

StringField* ml::DicomValueComboBoxSelectorTagInterface::_valueFld
protected

The value to be managed.

Definition at line 132 of file mlDicomValueComboBoxSelectorTagInterface.h.

Referenced by getValueFld().

◆ InheritModeStrings

const char* const ml::DicomValueComboBoxSelectorTagInterface::InheritModeStrings[NumInheritModeStrings]
static

Possible string values for ways how a tag value can be determined.

Definition at line 35 of file mlDicomValueComboBoxSelectorTagInterface.h.


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