QmitkUSAbstractCustomWidget Class Reference

Abstract superclass for all custom control widgets of mitk::USDevice classes. More...

#include <QmitkUSAbstractCustomWidget.h>

Inheritance diagram for QmitkUSAbstractCustomWidget:

Public Member Functions
	QmitkUSAbstractCustomWidget (QWidget *parent=nullptr)
	~QmitkUSAbstractCustomWidget () override
void	SetDevice (mitk::USDevice::Pointer device)
mitk::USDevice::Pointer	GetDevice () const
virtual void	OnDeviceSet ()=0
	Called every time a mitk::USDevice was set with QmitkUSAbstractCustomWidget::SetDevice(). A sublcass can implement this function to handle initialiation actions necessary when a device was set.
virtual std::string	GetDeviceClass () const =0
	Subclass must implement this method to return device class of corresponding mitk::USDevice.
virtual QmitkUSAbstractCustomWidget *	Clone (QWidget *parent=nullptr) const =0
	Subclass must implement this method to return a pointer to a copy of the object.
virtual void	Initialize ()=0
	Method for initializing the Qt stuff of the widget (setupUI, connect). This method will be called in CloneForQt() and has to be implemented by concrete subclasses.
QmitkUSAbstractCustomWidget *	CloneForQt (QWidget *parent=nullptr) const
	Return pointer to copy of the object. Internally use of QmitkUSAbstractCustomWidget::Clone() with additionaly setting an internal flag that the object was really cloned.
us::ServiceProperties	GetServiceProperties () const
	Returns the properties of the micro service. Properties consist of just the device class of the corresponding mitk::USDevice.
void	showEvent (QShowEvent *event) override
	Overwritten Qt even method. It is checked if the object was cloned with QmitkUSAbstractCustomWidget::CloneForQt() before. An exception is thrown if not. This is done, because using the object from micro service directly in Qt without cloning it first can cause problems after Qt deleted the object.

Static Public Member Functions
static std::string	US_DEVICE_PROPKEY_CLASS ()
	Property key for the class name of corresponding us device object.

Detailed Description

Abstract superclass for all custom control widgets of mitk::USDevice classes.

The custom control widgets are made available using a us::PrototypeServiceFactory. This means that each concrete subclass should be registered in the microservice by calling QmitkUSAbstractCustomWidget::RegisterService() on an object. The best place for doing this would be in the corresponding module or plugin activator.

Afterwards a copy of the registered object can be obtained from the microservice as shown in the example below. Do not forget to call QmitkUSAbstractCustomWidget::CloneForQt() on the object received from the microservice. This is necessary to allow deleting the object as it is necessary in Qt for removing it from a layout.

Subclasses must implement three methods:

• QmitkUSAbstractCustomWidget::OnDeviceSet() -> should handle initialization when mitk:USDevice was set
• QmitkUSAbstractCustomWidget::GetDeviceClass() -> must return device class of corresponding mitk::USDevice
• QmitkUSAbstractCustomWidget::Clone() -> must create a copy of the current object

The code to use a custom control widget in a plugin can look like this:

ctkPluginContext* pluginContext = // get the plugig context
mitk::USDevice device = // get the ultrasound device
 
// get service references for ultrasound device
std::string filter = "(org.mitk.services.UltrasoundCustomWidget.deviceClass=" + device->GetDeviceClass() + ")";
QString interfaceName ( us_service_interface_iid<QmitkUSAbstractCustomWidget>() );
QList<ctkServiceReference> serviceRefs = pluginContext->getServiceReferences(interfaceName, QString::fromStdString(filter));
 
if (serviceRefs.size() > 0)
{
  // get widget from the service and make sure that it is cloned, so that
  // it can be deleted if it should be removed from the GUI later
  QmitkUSAbstractCustomWidget* widget = pluginContext->getService<QmitkUSAbstractCustomWidget>
         (serviceRefs.at(0))->CloneForQt(parentWidget);
  // now the widget can be used like any other QWidget
}

Definition at line 65 of file QmitkUSAbstractCustomWidget.h.

Constructor & Destructor Documentation

QmitkUSAbstractCustomWidget()

QmitkUSAbstractCustomWidget::QmitkUSAbstractCustomWidget

(

QWidget *

parent = nullptr

)

Definition at line 21 of file QmitkUSAbstractCustomWidget.cpp.

~QmitkUSAbstractCustomWidget()

QmitkUSAbstractCustomWidget::~QmitkUSAbstractCustomWidget ( )

override

Definition at line 26 of file QmitkUSAbstractCustomWidget.cpp.

Member Function Documentation

Clone()

virtual QmitkUSAbstractCustomWidget * QmitkUSAbstractCustomWidget::Clone ( QWidget * parent = nullptr ) const

pure virtual

Subclass must implement this method to return a pointer to a copy of the object.

Implemented in QmitkUSControlsCustomVideoDeviceWidget.

CloneForQt()

QmitkUSAbstractCustomWidget * QmitkUSAbstractCustomWidget::CloneForQt

(

QWidget *

parent = nullptr

)

const

Return pointer to copy of the object. Internally use of QmitkUSAbstractCustomWidget::Clone() with additionaly setting an internal flag that the object was really cloned.

Definition at line 42 of file QmitkUSAbstractCustomWidget.cpp.

GetDevice()

mitk::USDevice::Pointer QmitkUSAbstractCustomWidget::GetDevice

(

)

const

Definition at line 37 of file QmitkUSAbstractCustomWidget.cpp.

GetDeviceClass()

virtual std::string QmitkUSAbstractCustomWidget::GetDeviceClass ( ) const

pure virtual

Subclass must implement this method to return device class of corresponding mitk::USDevice.

Returns

same value as mitk::USDevice::GetDeviceClass() of the corresponding mitk::USDevice

Implemented in QmitkUSControlsCustomVideoDeviceWidget.

GetServiceProperties()

us::ServiceProperties QmitkUSAbstractCustomWidget::GetServiceProperties

(

)

const

Returns the properties of the micro service. Properties consist of just the device class of the corresponding mitk::USDevice.

Definition at line 50 of file QmitkUSAbstractCustomWidget.cpp.

Initialize()

virtual void QmitkUSAbstractCustomWidget::Initialize ( )

pure virtual

Method for initializing the Qt stuff of the widget (setupUI, connect). This method will be called in CloneForQt() and has to be implemented by concrete subclasses.

Warning

All Qt initialization stuff belongs into this method rather than in the constructor.

Implemented in QmitkUSControlsCustomVideoDeviceWidget.

OnDeviceSet()

virtual void QmitkUSAbstractCustomWidget::OnDeviceSet ( )

pure virtual

Called every time a mitk::USDevice was set with QmitkUSAbstractCustomWidget::SetDevice(). A sublcass can implement this function to handle initialiation actions necessary when a device was set.

Implemented in QmitkUSControlsCustomVideoDeviceWidget.

SetDevice()

void QmitkUSAbstractCustomWidget::SetDevice

(

mitk::USDevice::Pointer

device

)

Definition at line 30 of file QmitkUSAbstractCustomWidget.cpp.

showEvent()

void QmitkUSAbstractCustomWidget::showEvent ( QShowEvent * event )

override

Overwritten Qt even method. It is checked if the object was cloned with QmitkUSAbstractCustomWidget::CloneForQt() before. An exception is thrown if not. This is done, because using the object from micro service directly in Qt without cloning it first can cause problems after Qt deleted the object.

Exceptions

mitk::Exception

Definition at line 59 of file QmitkUSAbstractCustomWidget.cpp.

US_DEVICE_PROPKEY_CLASS()

std::string QmitkUSAbstractCustomWidget::US_DEVICE_PROPKEY_CLASS ( )

static

Property key for the class name of corresponding us device object.

Definition at line 15 of file QmitkUSAbstractCustomWidget.cpp.

---

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

• Modules/USUI/Qmitk/QmitkUSAbstractCustomWidget.h
• Modules/USUI/Qmitk/QmitkUSAbstractCustomWidget.cpp