Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
QmitkPopupColorChooser Class Reference

A frameless popup widget for choosing colors from an HSV gradient. More...

#include <QmitkColorPropertyEditor.h>

Inheritance diagram for QmitkPopupColorChooser:
Collaboration diagram for QmitkPopupColorChooser:

Signals

void colorSelected (QColor color)
 Emitted when the user moves the mouse over a color or releases the mouse. More...
 

Public Member Functions

 QmitkPopupColorChooser (QWidget *parent=nullptr, unsigned int steps=16, unsigned int size=150)
 Construct the popup color chooser. More...
 
 ~QmitkPopupColorChooser () override
 Destructor. More...
 
void setSteps (int steps)
 Set the number of discrete steps for the color gradient. More...
 
virtual void popup (QWidget *parent, const QPoint &point, const mitk::Color *color=nullptr)
 Show the popup at the given position. More...
 

Protected Member Functions

void keyReleaseEvent (QKeyEvent *) override
 
void mouseMoveEvent (QMouseEvent *) override
 
void mouseReleaseEvent (QMouseEvent *) override
 
void closeEvent (QCloseEvent *) override
 
void paintEvent (QPaintEvent *) override
 
void drawGradient (QPainter *p)
 

Detailed Description

A frameless popup widget for choosing colors from an HSV gradient.

Displays a rectangular HSV color gradient that the user can click to select a color. The widget grabs mouse and keyboard input when shown, and closes on mouse release or key press. If a key is pressed, the original color is restored.

See also
QmitkColorPropertyEditor

Definition at line 32 of file QmitkColorPropertyEditor.h.

Constructor & Destructor Documentation

◆ QmitkPopupColorChooser()

QmitkPopupColorChooser::QmitkPopupColorChooser ( QWidget *  parent = nullptr,
unsigned int  steps = 16,
unsigned int  size = 150 
)

Construct the popup color chooser.

Parameters
[in]parentThe parent widget.
[in]stepsNumber of discrete color steps in the gradient.
[in]sizeWidth and height of the popup in pixels.

◆ ~QmitkPopupColorChooser()

QmitkPopupColorChooser::~QmitkPopupColorChooser ( )
override

Destructor.

Member Function Documentation

◆ closeEvent()

void QmitkPopupColorChooser::closeEvent ( QCloseEvent *  )
overrideprotected

◆ colorSelected

void QmitkPopupColorChooser::colorSelected ( QColor  color)
signal

Emitted when the user moves the mouse over a color or releases the mouse.

Parameters
[in]colorThe selected QColor.

◆ drawGradient()

void QmitkPopupColorChooser::drawGradient ( QPainter *  p)
protected

◆ keyReleaseEvent()

void QmitkPopupColorChooser::keyReleaseEvent ( QKeyEvent *  )
overrideprotected

◆ mouseMoveEvent()

void QmitkPopupColorChooser::mouseMoveEvent ( QMouseEvent *  )
overrideprotected

◆ mouseReleaseEvent()

void QmitkPopupColorChooser::mouseReleaseEvent ( QMouseEvent *  )
overrideprotected

◆ paintEvent()

void QmitkPopupColorChooser::paintEvent ( QPaintEvent *  )
overrideprotected

◆ popup()

virtual void QmitkPopupColorChooser::popup ( QWidget *  parent,
const QPoint &  point,
const mitk::Color *  color = nullptr 
)
virtual

Show the popup at the given position.

If a color is provided, the popup is positioned so that the matching color is under the cursor.

Parameters
[in]parentThe widget that triggered the popup.
[in]pointThe position in parent coordinates.
[in]colorOptional initial color to center the popup on.

◆ setSteps()

void QmitkPopupColorChooser::setSteps ( int  steps)

Set the number of discrete steps for the color gradient.

Parameters
[in]stepsNumber of gradient steps.

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