Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
QmitkSliderLevelWindowWidget Class Reference

Provides a widget with a slider to change the level and window value of the current image. More...

#include <QmitkSliderLevelWindowWidget.h>

Inheritance diagram for QmitkSliderLevelWindowWidget:
Collaboration diagram for QmitkSliderLevelWindowWidget:

Public Member Functions

 QmitkSliderLevelWindowWidget (QWidget *parent=nullptr, Qt::WindowFlags f={})
 Constructs the slider level/window widget. More...
 
 ~QmitkSliderLevelWindowWidget () override
 
void SetLevelWindowManager (mitk::LevelWindowManager *levelWindowManager)
 Sets the LevelWindowManager for this widget. More...
 
void SetDataStorage (mitk::DataStorage *ds)
 Sets the DataStorage that holds all image nodes. More...
 
mitk::LevelWindowManager * GetManager ()
 Returns the LevelWindowManager used by this widget. More...
 

Public Attributes

mitk::LevelWindow m_LevelWindow
 Stores the current level/window values. More...
 
mitk::LevelWindowManager::Pointer m_Manager
 The LevelWindowManager responsible for collecting and delivering level/window changes. More...
 

Protected Slots

void HideScale ()
 Hide the scale if "Hide Scale" is selected in the context menu. More...
 
void ShowScale ()
 Shows the scale if "Show Scale" is selected in the context menu. More...
 

Protected Member Functions

virtual void Update ()
 recalculate the size and position of the slider bar More...
 
void paintEvent (QPaintEvent *e) override
 
void mouseMoveEvent (QMouseEvent *mouseEvent) override
 
void enterEvent (QEnterEvent *event) override
 
void mousePressEvent (QMouseEvent *mouseEvent) override
 
void mouseReleaseEvent (QMouseEvent *mouseEvent) override
 
void resizeEvent (QResizeEvent *event) override
 

Protected Attributes

QRect m_Rect
 
QPoint m_StartPos
 
bool m_Resize
 
bool m_Bottom
 
bool m_MouseDown
 
bool m_Leftbutton
 
bool m_CtrlPressed
 
int m_MoveHeight
 
bool m_ScaleVisible
 
QRect m_LowerBound
 
QRect m_UpperBound
 
unsigned long m_ObserverTag
 
bool m_IsObserverTagSet
 
QFont m_Font
 
QmitkLevelWindowWidgetContextMenu * m_Contextmenu
 

Detailed Description

Provides a widget with a slider to change the level and window value of the current image.

This documentation actually refers to the QmitkLevelWindowWidget and is only put in this class due to technical issues (should be moved later).

The QmitkLevelWindowWidget is a kind of container for a QmitkSliderLevelWindowWidget (this is the cyan bar above the text input fields) and a QmitkLineEditLevelWindowWidget (with two text input fields). It holds a reference to a mitk::LevelWindowManager variable, which keeps the LevelWindowProperty of the currently selected image. Level/Window is manipulated by the text inputs and the Slider to adjust brightness/contrast of a single image. All changes on the slider or in the text input fields affect the current image by giving new values to LevelWindowManager. LevelWindowManager then sends a signal to tell other listeners about changes.

Which image is changed is determined by mitkLevelWindowManager. If m_AutoTopMost is true, always the topmost image in data tree (layer property) is affected by changes. The image which is affected by changes can also be changed by QmitkLevelWindowWidgetContextMenu, the context menu for QmitkSliderLevelWindowWidget and QmitkLineEditLevelWindowWidget. There you have the possibility to set a certain image or always the topmost image in the data tree (layer property) to be affected by changes.

The internal mitk::LevelWindow variable contains a range that is valid for a given image. It should not be possible to move the level/window parameters outside this range. The range can be changed and reset to its default values by QmitkLevelWindowWidgetContextMenu, the context menu for QmitkSliderLevelWindowWidget and QmitkLineEditLevelWindowWidget.

Now for the behaviour of the text inputs: The upper one contains the value of the level (brightness), the lower one shows the window (contrast).

The behaviour of the cyan bar is more obvious: the scale in the background shows the valid range. The cyan bar in front displays the currently selected level/window setting. You can change the level by dragging the bar with the left mouse button or clicking somewhere inside the scalerange with the left mouse button. The window is changed by moving the mouse on the upper or lower bound of the bar until the cursor becomes an vertical double-arrowed symbol. Then you can change the windowsize by clicking the left mouse button and move the mouse upwards or downwards. The bar becomes greater upwards as well as downwards. If you want to change the size of the window in only one direction you have to press the CTRL-key while doing the same as mentioned above. This information is also presented by a tooltip text when moving the mouse on the upper or lower bound of the bar.

Definition at line 77 of file QmitkSliderLevelWindowWidget.h.

Constructor & Destructor Documentation

◆ QmitkSliderLevelWindowWidget()

QmitkSliderLevelWindowWidget::QmitkSliderLevelWindowWidget ( QWidget *  parent = nullptr,
Qt::WindowFlags  f = {} 
)

Constructs the slider level/window widget.

Parameters
[in]parentOptional parent widget.
[in]fOptional window flags.

◆ ~QmitkSliderLevelWindowWidget()

QmitkSliderLevelWindowWidget::~QmitkSliderLevelWindowWidget ( )
override

Member Function Documentation

◆ enterEvent()

void QmitkSliderLevelWindowWidget::enterEvent ( QEnterEvent *  event)
overrideprotected

◆ GetManager()

mitk::LevelWindowManager* QmitkSliderLevelWindowWidget::GetManager ( )

Returns the LevelWindowManager used by this widget.

Returns
Pointer to the LevelWindowManager.

◆ HideScale

void QmitkSliderLevelWindowWidget::HideScale ( )
protectedslot

Hide the scale if "Hide Scale" is selected in the context menu.

◆ mouseMoveEvent()

void QmitkSliderLevelWindowWidget::mouseMoveEvent ( QMouseEvent *  mouseEvent)
overrideprotected

method implements the component behavior

checks if cursor is on upper or lower bound of slider bar and changes cursor symbol

checks if left mouse button is pressed and if CTRL is pressed and changes sliderbar in move-direction accordingly

◆ mousePressEvent()

void QmitkSliderLevelWindowWidget::mousePressEvent ( QMouseEvent *  mouseEvent)
overrideprotected

registers events when a mousebutton is pressed

if leftbutton is pressed m_Leftbutton is set to true

also checks if CTRL is pressed and sets the bool variable m_CtrlPressed

◆ mouseReleaseEvent()

void QmitkSliderLevelWindowWidget::mouseReleaseEvent ( QMouseEvent *  mouseEvent)
overrideprotected

sets the variable m_MouseDown to false

◆ paintEvent()

void QmitkSliderLevelWindowWidget::paintEvent ( QPaintEvent *  e)
overrideprotected

repaint the slider and the scale

◆ resizeEvent()

void QmitkSliderLevelWindowWidget::resizeEvent ( QResizeEvent *  event)
overrideprotected

causes an update of the sliderbar when resizing the window

◆ SetDataStorage()

void QmitkSliderLevelWindowWidget::SetDataStorage ( mitk::DataStorage *  ds)

Sets the DataStorage that holds all image nodes.

Parameters
[in]dsThe data storage to set.

◆ SetLevelWindowManager()

void QmitkSliderLevelWindowWidget::SetLevelWindowManager ( mitk::LevelWindowManager *  levelWindowManager)

Sets the LevelWindowManager for this widget.

Parameters
[in]levelWindowManagerThe manager to use for level/window changes.

◆ ShowScale

void QmitkSliderLevelWindowWidget::ShowScale ( )
protectedslot

Shows the scale if "Show Scale" is selected in the context menu.

◆ Update()

virtual void QmitkSliderLevelWindowWidget::Update ( )
protectedvirtual

recalculate the size and position of the slider bar

Member Data Documentation

◆ m_Bottom

bool QmitkSliderLevelWindowWidget::m_Bottom
protected

Definition at line 137 of file QmitkSliderLevelWindowWidget.h.

◆ m_Contextmenu

QmitkLevelWindowWidgetContextMenu* QmitkSliderLevelWindowWidget::m_Contextmenu
protected

data structure which creates the context menu for QmitkLineEditLevelWindowWidget

Definition at line 153 of file QmitkSliderLevelWindowWidget.h.

◆ m_CtrlPressed

bool QmitkSliderLevelWindowWidget::m_CtrlPressed
protected

Definition at line 140 of file QmitkSliderLevelWindowWidget.h.

◆ m_Font

QFont QmitkSliderLevelWindowWidget::m_Font
protected

Definition at line 148 of file QmitkSliderLevelWindowWidget.h.

◆ m_IsObserverTagSet

bool QmitkSliderLevelWindowWidget::m_IsObserverTagSet
protected

Definition at line 146 of file QmitkSliderLevelWindowWidget.h.

◆ m_Leftbutton

bool QmitkSliderLevelWindowWidget::m_Leftbutton
protected

Definition at line 139 of file QmitkSliderLevelWindowWidget.h.

◆ m_LevelWindow

mitk::LevelWindow QmitkSliderLevelWindowWidget::m_LevelWindow

Stores the current level/window values.

Definition at line 110 of file QmitkSliderLevelWindowWidget.h.

◆ m_LowerBound

QRect QmitkSliderLevelWindowWidget::m_LowerBound
protected

Definition at line 143 of file QmitkSliderLevelWindowWidget.h.

◆ m_Manager

mitk::LevelWindowManager::Pointer QmitkSliderLevelWindowWidget::m_Manager

The LevelWindowManager responsible for collecting and delivering level/window changes.

Definition at line 113 of file QmitkSliderLevelWindowWidget.h.

◆ m_MouseDown

bool QmitkSliderLevelWindowWidget::m_MouseDown
protected

Definition at line 138 of file QmitkSliderLevelWindowWidget.h.

◆ m_MoveHeight

int QmitkSliderLevelWindowWidget::m_MoveHeight
protected

Definition at line 141 of file QmitkSliderLevelWindowWidget.h.

◆ m_ObserverTag

unsigned long QmitkSliderLevelWindowWidget::m_ObserverTag
protected

Definition at line 145 of file QmitkSliderLevelWindowWidget.h.

◆ m_Rect

QRect QmitkSliderLevelWindowWidget::m_Rect
protected

helper for drawing the component

Definition at line 129 of file QmitkSliderLevelWindowWidget.h.

◆ m_Resize

bool QmitkSliderLevelWindowWidget::m_Resize
protected

Definition at line 136 of file QmitkSliderLevelWindowWidget.h.

◆ m_ScaleVisible

bool QmitkSliderLevelWindowWidget::m_ScaleVisible
protected

Definition at line 142 of file QmitkSliderLevelWindowWidget.h.

◆ m_StartPos

QPoint QmitkSliderLevelWindowWidget::m_StartPos
protected

helper for drawing the component

Definition at line 134 of file QmitkSliderLevelWindowWidget.h.

◆ m_UpperBound

QRect QmitkSliderLevelWindowWidget::m_UpperBound
protected

Definition at line 144 of file QmitkSliderLevelWindowWidget.h.


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