Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
QmitkDicomLocalStorageWidget Class Reference

Widget for managing a persistent local DICOM storage database. More...

#include <QmitkDicomLocalStorageWidget.h>

Inheritance diagram for QmitkDicomLocalStorageWidget:
Collaboration diagram for QmitkDicomLocalStorageWidget:

Public Slots

void OnImport (const QStringList &files)
 Imports the given DICOM files into the local database. More...
 

Signals

void IndexingComplete ()
 Emitted when the indexing of newly imported DICOM data is complete. More...
 
void ViewSeries (const std::vector< std::pair< std::string, std::optional< std::string >>> &series)
 Emitted when the View button is clicked to load selected series. More...
 

Public Member Functions

 QmitkDicomLocalStorageWidget (QWidget *parent=nullptr)
 Constructor. More...
 
 ~QmitkDicomLocalStorageWidget () override
 Destructor. More...
 
QSharedPointer< ctkDICOMDatabase > SetDatabaseDirectory (const QString &databaseDirectory)
 Sets the directory for the local storage DICOM database. More...
 

Detailed Description

Widget for managing a persistent local DICOM storage database.

This widget wraps a ctkDICOMTableManager for browsing patients, studies, and series stored in a local SQLite-based DICOM database. It provides buttons to view selected series and to delete selected patients, studies, or series from the database. Files can be imported into the local database via the OnImport() slot.

See also
QmitkDicomImportWidget

Definition at line 39 of file QmitkDicomLocalStorageWidget.h.

Constructor & Destructor Documentation

◆ QmitkDicomLocalStorageWidget()

QmitkDicomLocalStorageWidget::QmitkDicomLocalStorageWidget ( QWidget *  parent = nullptr)
explicit

Constructor.

Parameters
[in]parentOptional parent widget.

◆ ~QmitkDicomLocalStorageWidget()

QmitkDicomLocalStorageWidget::~QmitkDicomLocalStorageWidget ( )
override

Destructor.

Member Function Documentation

◆ IndexingComplete

void QmitkDicomLocalStorageWidget::IndexingComplete ( )
signal

Emitted when the indexing of newly imported DICOM data is complete.

◆ OnImport

void QmitkDicomLocalStorageWidget::OnImport ( const QStringList &  files)
slot

Imports the given DICOM files into the local database.

The files are indexed asynchronously. The IndexingComplete() signal is emitted when the indexing finishes.

Parameters
[in]filesList of DICOM file paths to import.
Precondition
The local database must be open (SetDatabaseDirectory() must have been called).

◆ SetDatabaseDirectory()

QSharedPointer<ctkDICOMDatabase> QmitkDicomLocalStorageWidget::SetDatabaseDirectory ( const QString &  databaseDirectory)

Sets the directory for the local storage DICOM database.

This method must be called to fully initialize the widget. It creates or opens the SQLite database in the specified directory and connects it to the internal ctkDICOMTableManager and ctkDICOMIndexer.

The returned database pointer can be passed to a ctkDICOMQueryRetrieveWidget as the retrieve database.

Parameters
[in]databaseDirectoryPath to a directory used for storing the local DICOM database. Created if it does not exist.
Returns
A shared pointer to the ctkDICOMDatabase.

◆ ViewSeries

void QmitkDicomLocalStorageWidget::ViewSeries ( const std::vector< std::pair< std::string, std::optional< std::string >>> &  series)
signal

Emitted when the View button is clicked to load selected series.

Parameters
[in]seriesA vector of pairs, each containing the first file path of a series and optionally its DICOM Modality string (tag 0008,0060).

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