Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
QmitkNumberPropertyEditor Class Reference

A QSpinBox that edits numeric MITK properties (int, float, double). More...

#include <QmitkNumberPropertyEditor.h>

Inheritance diagram for QmitkNumberPropertyEditor:
Collaboration diagram for QmitkNumberPropertyEditor:

Public Member Functions

 QmitkNumberPropertyEditor (mitk::IntProperty *property, QWidget *parent)
 Construct an editor for an integer property. More...
 
 QmitkNumberPropertyEditor (mitk::FloatProperty *property, QWidget *parent)
 Construct an editor for a float property. More...
 
 QmitkNumberPropertyEditor (mitk::DoubleProperty *property, QWidget *parent)
 Construct an editor for a double property. More...
 
 ~QmitkNumberPropertyEditor () override
 Destructor. More...
 
short getDecimalPlaces () const
 Get the number of decimal places shown. More...
 
void setDecimalPlaces (short places)
 Set the number of decimal places (only effective for float/double properties). More...
 
bool getShowPercent () const
 Check whether values are displayed as percentages. More...
 
void setShowPercent (bool showPercent)
 Enable or disable percentage display (e.g. 0.5 displayed as 50%). More...
 
int minValue () const
 Get the minimum allowed value. More...
 
void setMinValue (int value)
 Set the minimum allowed value. More...
 
int maxValue () const
 Get the maximum allowed value. More...
 
void setMaxValue (int value)
 Set the maximum allowed value. More...
 
double doubleValue () const
 Get the current value as a double. More...
 
void setDoubleValue (double value)
 Set the current value from a double. More...
 
- Public Member Functions inherited from mitk::PropertyEditor
 PropertyEditor (mitk::BaseProperty *property)
 Constructor. Begins observing the given property. More...
 
 ~PropertyEditor () override
 Destructor. Removes the ITK observer from the property. More...
 
void OnModified (const itk::EventObject &e)
 Callback for itk::ModifiedEvent on the observed property. More...
 
void OnDelete (const itk::EventObject &e)
 Callback for itk::DeleteEvent on the observed property. More...
 
- Public Member Functions inherited from mitk::PropertyObserver
 PropertyObserver ()
 Constructor. More...
 
virtual ~PropertyObserver ()
 Virtual destructor. More...
 

Protected Slots

void onValueChanged (int)
 

Protected Member Functions

void initialize ()
 
QString textFromValue (int) const override
 
int valueFromText (const QString &) const override
 
void PropertyChanged () override
 Called when the observed property value has changed. More...
 
void PropertyRemoved () override
 Called when the observed property is about to be deleted. More...
 
void DisplayNumber ()
 
- Protected Member Functions inherited from mitk::PropertyObserver
void BeginModifyProperty ()
 Marks the beginning of a self-initiated property modification. More...
 
void EndModifyProperty ()
 Marks the end of a self-initiated property modification. More...
 

Protected Attributes

union {
   mitk::GenericProperty< int > *   m_IntProperty
 
   mitk::GenericProperty< float > *   m_FloatProperty
 
   mitk::GenericProperty< double > *   m_DoubleProperty
 
}; 
 
const int m_DataType
 
short m_DecimalPlaces
 
double m_FactorPropertyToSpinbox
 
double m_FactorSpinboxToDisplay
 
bool m_ShowPercents
 
- Protected Attributes inherited from mitk::PropertyEditor
mitk::BaseProperty * m_Property
 The observed property (read-write). More...
 
- Protected Attributes inherited from mitk::PropertyObserver
unsigned long m_ModifiedTag
 ITK observer tag for the ModifiedEvent. More...
 
unsigned long m_DeleteTag
 ITK observer tag for the DeleteEvent. More...
 
bool m_SelfCall
 Guard flag to prevent re-entrant notification. More...
 

Properties

short decimalPlaces
 
bool showPercent
 
int minValue
 
int maxValue
 

Detailed Description

A QSpinBox that edits numeric MITK properties (int, float, double).

Provides a spinbox editor that bidirectionally synchronizes with an mitk::IntProperty, mitk::FloatProperty, or mitk::DoubleProperty. Supports configurable decimal places, percentage display mode, and min/max ranges. Internally converts between the property's floating-point value and the spinbox's integer-based value using scale factors.

See also
QmitkNumberPropertySlider, QmitkNumberPropertyView, QmitkPropertyViewFactory

Definition at line 31 of file QmitkNumberPropertyEditor.h.

Constructor & Destructor Documentation

◆ QmitkNumberPropertyEditor() [1/3]

QmitkNumberPropertyEditor::QmitkNumberPropertyEditor ( mitk::IntProperty *  property,
QWidget *  parent 
)

Construct an editor for an integer property.

Parameters
[in]propertyThe int property to edit.
[in]parentThe parent widget.

◆ QmitkNumberPropertyEditor() [2/3]

QmitkNumberPropertyEditor::QmitkNumberPropertyEditor ( mitk::FloatProperty *  property,
QWidget *  parent 
)

Construct an editor for a float property.

Parameters
[in]propertyThe float property to edit.
[in]parentThe parent widget.

◆ QmitkNumberPropertyEditor() [3/3]

QmitkNumberPropertyEditor::QmitkNumberPropertyEditor ( mitk::DoubleProperty *  property,
QWidget *  parent 
)

Construct an editor for a double property.

Parameters
[in]propertyThe double property to edit.
[in]parentThe parent widget.

◆ ~QmitkNumberPropertyEditor()

QmitkNumberPropertyEditor::~QmitkNumberPropertyEditor ( )
override

Destructor.

Member Function Documentation

◆ DisplayNumber()

void QmitkNumberPropertyEditor::DisplayNumber ( )
protected

◆ doubleValue()

double QmitkNumberPropertyEditor::doubleValue ( ) const

Get the current value as a double.

Returns
The property value.

◆ getDecimalPlaces()

short QmitkNumberPropertyEditor::getDecimalPlaces ( ) const

Get the number of decimal places shown.

Returns
The decimal places count.

◆ getShowPercent()

bool QmitkNumberPropertyEditor::getShowPercent ( ) const

Check whether values are displayed as percentages.

Returns
True if percentage mode is active.

◆ initialize()

void QmitkNumberPropertyEditor::initialize ( )
protected

◆ maxValue()

int QmitkNumberPropertyEditor::maxValue ( ) const

Get the maximum allowed value.

Returns
The maximum value.

◆ minValue()

int QmitkNumberPropertyEditor::minValue ( ) const

Get the minimum allowed value.

Returns
The minimum value.

◆ onValueChanged

void QmitkNumberPropertyEditor::onValueChanged ( int  )
protectedslot

◆ PropertyChanged()

void QmitkNumberPropertyEditor::PropertyChanged ( )
overrideprotectedvirtual

Called when the observed property value has changed.

Implements mitk::PropertyObserver.

◆ PropertyRemoved()

void QmitkNumberPropertyEditor::PropertyRemoved ( )
overrideprotectedvirtual

Called when the observed property is about to be deleted.

Implements mitk::PropertyObserver.

◆ setDecimalPlaces()

void QmitkNumberPropertyEditor::setDecimalPlaces ( short  places)

Set the number of decimal places (only effective for float/double properties).

Parameters
[in]placesThe number of decimal places.

◆ setDoubleValue()

void QmitkNumberPropertyEditor::setDoubleValue ( double  value)

Set the current value from a double.

Parameters
[in]valueThe value to set.

◆ setMaxValue()

void QmitkNumberPropertyEditor::setMaxValue ( int  value)

Set the maximum allowed value.

Parameters
[in]valueThe maximum value.

◆ setMinValue()

void QmitkNumberPropertyEditor::setMinValue ( int  value)

Set the minimum allowed value.

Parameters
[in]valueThe minimum value.

◆ setShowPercent()

void QmitkNumberPropertyEditor::setShowPercent ( bool  showPercent)

Enable or disable percentage display (e.g. 0.5 displayed as 50%).

Parameters
[in]showPercentTrue to enable percentage mode.

◆ textFromValue()

QString QmitkNumberPropertyEditor::textFromValue ( int  ) const
overrideprotected

◆ valueFromText()

int QmitkNumberPropertyEditor::valueFromText ( const QString &  ) const
overrideprotected

Member Data Documentation

◆ 

union { ... }

◆ m_DataType

const int QmitkNumberPropertyEditor::m_DataType
protected

Definition at line 141 of file QmitkNumberPropertyEditor.h.

◆ m_DecimalPlaces

short QmitkNumberPropertyEditor::m_DecimalPlaces
protected

Definition at line 143 of file QmitkNumberPropertyEditor.h.

◆ m_DoubleProperty

mitk::GenericProperty<double>* QmitkNumberPropertyEditor::m_DoubleProperty

Definition at line 138 of file QmitkNumberPropertyEditor.h.

◆ m_FactorPropertyToSpinbox

double QmitkNumberPropertyEditor::m_FactorPropertyToSpinbox
protected

Definition at line 144 of file QmitkNumberPropertyEditor.h.

◆ m_FactorSpinboxToDisplay

double QmitkNumberPropertyEditor::m_FactorSpinboxToDisplay
protected

Definition at line 145 of file QmitkNumberPropertyEditor.h.

◆ m_FloatProperty

mitk::GenericProperty<float>* QmitkNumberPropertyEditor::m_FloatProperty

Definition at line 137 of file QmitkNumberPropertyEditor.h.

◆ m_IntProperty

mitk::GenericProperty<int>* QmitkNumberPropertyEditor::m_IntProperty

Definition at line 136 of file QmitkNumberPropertyEditor.h.

◆ m_ShowPercents

bool QmitkNumberPropertyEditor::m_ShowPercents
protected

Definition at line 146 of file QmitkNumberPropertyEditor.h.

Property Documentation

◆ decimalPlaces

short QmitkNumberPropertyEditor::decimalPlaces
readwrite

Definition at line 1 of file QmitkNumberPropertyEditor.h.

◆ maxValue

int QmitkNumberPropertyEditor::maxValue
readwrite

Definition at line 1 of file QmitkNumberPropertyEditor.h.

◆ minValue

int QmitkNumberPropertyEditor::minValue
readwrite

Definition at line 1 of file QmitkNumberPropertyEditor.h.

◆ showPercent

bool QmitkNumberPropertyEditor::showPercent
readwrite

Definition at line 1 of file QmitkNumberPropertyEditor.h.


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