Subject hierarchy folder plugin. More...

#include <Modules/Loadable/SubjectHierarchy/Widgets/qSlicerSubjectHierarchyFolderPlugin.h>

Inheritance diagram for qSlicerSubjectHierarchyFolderPlugin:

[legend]

Collaboration diagram for qSlicerSubjectHierarchyFolderPlugin:

[legend]

Public Types
typedef qSlicerSubjectHierarchyAbstractPlugin	Superclass

Public Types inherited from qSlicerSubjectHierarchyAbstractPlugin
enum	ActionSectionType { SectionTop = -400 , SectionInteraction = -300 , SectionComponent = -200 , SectionNode = -100 , SectionDefault = 0 , SectionFolder = 100 , SectionBottom = 200 }

typedef QObject	Superclass

Public Member Functions
bool	addNodeToSubjectHierarchy (vtkMRMLNode *node, vtkIdType parentItemID) override
	Make sure a folder display node that is added externally shows up in the hierarchy.

double	canAddNodeToSubjectHierarchy (vtkMRMLNode *node, vtkIdType parentItemID=vtkMRMLSubjectHierarchyNode::INVALID_ITEM_ID) const override

double	canOwnSubjectHierarchyItem (vtkIdType itemID) const override

Q_INVOKABLE QString	colorItemAttributeName () const
	Name of color attribute in folder subject hierarchy items.

vtkMRMLDisplayNode *	createDisplayNodeForItem (vtkIdType itemID)

Q_INVOKABLE vtkIdType	createFolderUnderItem (vtkIdType parentItemID)

void	editProperties (vtkIdType itemID) override
	Open module belonging to item and set inputs in opened module.

void	emptyFolderCreatedFromTreeView (qMRMLSubjectHierarchyTreeView *treeView)

QColor	getDisplayColor (vtkIdType itemID, QMap< int, QVariant > &terminologyMetaData) const override

int	getDisplayVisibility (vtkIdType itemID) const override

QIcon	icon (vtkIdType itemID) override

QList< QAction * >	itemContextMenuActions () const override
	Get item context menu item actions to add to tree view.

	qSlicerSubjectHierarchyFolderPlugin (QObject *parent=nullptr)

Q_INVOKABLE const QString	roleForPlugin () const override

QList< QAction * >	sceneContextMenuActions () const override

void	setDisplayColor (vtkIdType itemID, QColor color, QMap< int, QVariant > terminologyMetaData) override

void	setDisplayVisibility (vtkIdType itemID, int visible) override
	Set display visibility of an owned subject hierarchy item.

void	showContextMenuActionsForItem (vtkIdType itemID) override

void	showVisibilityContextMenuActionsForItem (vtkIdType itemID) override

QList< QAction * >	visibilityContextMenuActions () const override

QIcon	visibilityIcon (int visible) override
	Get visibility icon for a visibility state.

	~qSlicerSubjectHierarchyFolderPlugin () override

Public Member Functions inherited from qSlicerSubjectHierarchyAbstractPlugin
virtual Q_INVOKABLE bool	canEditProperties (vtkIdType itemID)
	Returns true if the module can edit properties of this item using editProperties.

virtual Q_INVOKABLE double	canReparentItemInsideSubjectHierarchy (vtkIdType itemID, vtkIdType parentItemID) const

Q_INVOKABLE QColor	colorAndTerminologyFromDisplayableNode (vtkIdType itemID, QMap< int, QVariant > &terminologyMetaData, bool useSelectedColor) const

virtual Q_INVOKABLE QString	displayedItemName (vtkIdType itemID) const

virtual const QString	helpText () const
	Get help text for plugin to be added in subject hierarchy module widget help box.

Q_INVOKABLE bool	isThisPluginOwnerOfItem (vtkIdType itemID) const
	Determines if the item is owned by this plugin.

virtual QString	name () const
	Get the name of the plugin.

	qSlicerSubjectHierarchyAbstractPlugin (QObject *parent=nullptr)

virtual Q_INVOKABLE bool	reparentItemInsideSubjectHierarchy (vtkIdType itemID, vtkIdType parentItemID)

Q_INVOKABLE void	setColorAndTerminologyToDisplayableNode (vtkIdType itemID, QColor color, QMap< int, QVariant > terminologyMetaData, bool useSelectedColor, bool disableScalarVisibility)

virtual void	setName (QString name)

virtual Q_INVOKABLE bool	showItemInView (vtkIdType itemID, vtkMRMLAbstractViewNode viewNode, vtkIdList allItemsToShow)

virtual Q_INVOKABLE void	showTransformContextMenuActionsForItem (vtkIdType itemID)

virtual Q_INVOKABLE void	showViewContextMenuActionsForItem (vtkIdType itemID, QVariantMap eventData)

virtual Q_INVOKABLE QString	tooltip (vtkIdType itemID) const
	Generate tooltip for a owned subject hierarchy item.

virtual Q_INVOKABLE QList< QAction * >	transformContextMenuActions () const

virtual Q_INVOKABLE QList< QAction * >	viewContextMenuActions () const

	~qSlicerSubjectHierarchyAbstractPlugin () override

Protected Slots
void	createFolderUnderCurrentNode ()
	Create folder node under current node.

void	createFolderUnderScene ()
	Create folder node under the scene.

void	onApplyColorToBranchToggled (bool)
	Toggle apply color to branch.

void	onShowEmptyFoldersToggled (bool)
	Toggle empty folder visibility (.

Protected Member Functions
vtkMRMLDisplayNode *	displayNodeForItem (vtkIdType itemID) const

bool	isApplyColorToBranchEnabledForItem (vtkIdType itemID) const
	Determine if apply color to branch option is enabled to a given item or not.

void	setApplyColorToBranchEnabledForItem (vtkIdType itemID, bool enabled)
	Determine if apply color to branch option is enabled to a given item or not.

void	updateShowEmptyFoldersAction ()

Protected Member Functions inherited from qSlicerSubjectHierarchyAbstractPlugin
void	hideAllContextMenuActions () const

Protected Attributes
QScopedPointer< qSlicerSubjectHierarchyFolderPluginPrivate >	d_ptr

Protected Attributes inherited from qSlicerSubjectHierarchyAbstractPlugin
QString	m_Name
	Name of the plugin.

Additional Inherited Members
Properties inherited from qSlicerSubjectHierarchyAbstractPlugin
QString	helpText

QString	name

Signals inherited from qSlicerSubjectHierarchyAbstractPlugin
void	requestExpandItem (vtkIdType itemID)
	Signal requesting expanding of the subject hierarchy tree item belonging to an item.

void	requestInvalidateFilter () const

Static Public Member Functions inherited from qSlicerSubjectHierarchyAbstractPlugin
static Q_INVOKABLE void	setActionPosition (QAction *action, int section, int weight=0, double weightAdjustment=0.0)

static Q_INVOKABLE qSlicerAbstractModuleWidget *	switchToModule (QString moduleName)

Detailed Description

Subject hierarchy folder plugin.

Support folder items in subject hierarchy

Folders define hierarchies in subject hierarchy.
Folder items have a directly associated display node after any interaction with display settings of the folder. A special display node type vtkMRMLFolderDisplayNode is used.
Folders have a feature for overriding display properties of the displayable nodes in its branch. If the user activates it, then all the child displayable nodes use the display settings from the display node associated to the folder.

Definition at line 53 of file qSlicerSubjectHierarchyFolderPlugin.h.

Member Typedef Documentation

◆ Superclass

typedef qSlicerSubjectHierarchyAbstractPlugin qSlicerSubjectHierarchyFolderPlugin::Superclass

Definition at line 60 of file qSlicerSubjectHierarchyFolderPlugin.h.

Constructor & Destructor Documentation

◆ qSlicerSubjectHierarchyFolderPlugin()

qSlicerSubjectHierarchyFolderPlugin::qSlicerSubjectHierarchyFolderPlugin ( QObject * parent = nullptr )

◆ ~qSlicerSubjectHierarchyFolderPlugin()

qSlicerSubjectHierarchyFolderPlugin::~qSlicerSubjectHierarchyFolderPlugin ( )

override

Member Function Documentation

◆ addNodeToSubjectHierarchy()

bool qSlicerSubjectHierarchyFolderPlugin::addNodeToSubjectHierarchy	(	vtkMRMLNode *	node,
		vtkIdType	parentItemID )

overridevirtual

Make sure a folder display node that is added externally shows up in the hierarchy.

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ canAddNodeToSubjectHierarchy()

double qSlicerSubjectHierarchyFolderPlugin::canAddNodeToSubjectHierarchy	(	vtkMRMLNode *	node,
		vtkIdType	parentItemID = vtkMRMLSubjectHierarchyNode::INVALID_ITEM_ID ) const

overridevirtual

Determines if a data node can be placed in the hierarchy using the actual plugin, and gets a confidence value for a certain MRML node (usually the type and possibly attributes are checked).

Parameters

node	Node to be added to the hierarchy
parentItemID	Prospective parent of the node to add. Default value is invalid. In that case the parent will be ignored, the confidence numbers are got based on the to-be child node alone.

Returns: Floating point confidence number between 0 and 1, where 0 means that the plugin cannot handle the node, and 1 means that the plugin is the only one that can handle the node (by node type or identifier attribute)

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ canOwnSubjectHierarchyItem()

double qSlicerSubjectHierarchyFolderPlugin::canOwnSubjectHierarchyItem ( vtkIdType itemID ) const

overridevirtual

Determines if the actual plugin can handle a subject hierarchy item. The plugin with the highest confidence number will "own" the item in the subject hierarchy (set icon, tooltip, set context menu etc.)

Parameters

item	Item to handle in the subject hierarchy tree

Returns: Floating point confidence number between 0 and 1, where 0 means that the plugin cannot handle the item, and 1 means that the plugin is the only one that can handle the item (by node type or identifier attribute)

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ colorItemAttributeName()

Q_INVOKABLE QString qSlicerSubjectHierarchyFolderPlugin::colorItemAttributeName ( ) const

inline

Name of color attribute in folder subject hierarchy items.

Definition at line 146 of file qSlicerSubjectHierarchyFolderPlugin.h.

◆ createDisplayNodeForItem()

vtkMRMLDisplayNode * qSlicerSubjectHierarchyFolderPlugin::createDisplayNodeForItem ( vtkIdType itemID )

Create model display node for given item. If the folder item has an associated model hierarchy node, then create a display node associated to that. Otherwise create display node for folder item

◆ createFolderUnderCurrentNode

void qSlicerSubjectHierarchyFolderPlugin::createFolderUnderCurrentNode ( )

protectedslot

Create folder node under current node.

◆ createFolderUnderItem()

Q_INVOKABLE vtkIdType qSlicerSubjectHierarchyFolderPlugin::createFolderUnderItem ( vtkIdType parentItemID )

Create folder under specified item

Parameters

parentNode Parent item for folder to create

◆ createFolderUnderScene

void qSlicerSubjectHierarchyFolderPlugin::createFolderUnderScene ( )

protectedslot

Create folder node under the scene.

◆ displayNodeForItem()

vtkMRMLDisplayNode * qSlicerSubjectHierarchyFolderPlugin::displayNodeForItem ( vtkIdType itemID ) const

protected

Retrieve model display node for given item. If the folder item has an associated model display node (created by the plugin), then return that. Otherwise see if it has a model hierarchy node with a display node.

◆ editProperties()

void qSlicerSubjectHierarchyFolderPlugin::editProperties ( vtkIdType itemID )

overridevirtual

Open module belonging to item and set inputs in opened module.

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ emptyFolderCreatedFromTreeView()

void qSlicerSubjectHierarchyFolderPlugin::emptyFolderCreatedFromTreeView ( qMRMLSubjectHierarchyTreeView * treeView )

Add tree view to the list of view from which empty folders have been created. This function is called from the DICOM plugin, which can create patient and study items (which are special folders).

◆ getDisplayColor()

QColor qSlicerSubjectHierarchyFolderPlugin::getDisplayColor	(	vtkIdType	itemID,
		QMap< int, QVariant > &	terminologyMetaData ) const

overridevirtual

Get display color of an owned subject hierarchy item In case of folders only color is set but no terminology. The properties are not used directly, but only if applied to the branch (similarly to how it worked in model hierarchies).

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ getDisplayVisibility()

int qSlicerSubjectHierarchyFolderPlugin::getDisplayVisibility ( vtkIdType itemID ) const

overridevirtual

Get display visibility of an owned subject hierarchy item

Returns: Display visibility (0: hidden, 1: shown, 2: partially shown)

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ icon()

QIcon qSlicerSubjectHierarchyFolderPlugin::icon ( vtkIdType itemID )

overridevirtual

Get icon of an owned subject hierarchy item

Returns: Icon to set, nullptr if nothing to set

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ isApplyColorToBranchEnabledForItem()

bool qSlicerSubjectHierarchyFolderPlugin::isApplyColorToBranchEnabledForItem ( vtkIdType itemID ) const

protected

Determine if apply color to branch option is enabled to a given item or not.

◆ itemContextMenuActions()

QList< QAction * > qSlicerSubjectHierarchyFolderPlugin::itemContextMenuActions ( ) const

overridevirtual

Get item context menu item actions to add to tree view.

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ onApplyColorToBranchToggled

void qSlicerSubjectHierarchyFolderPlugin::onApplyColorToBranchToggled ( bool )

protectedslot

Toggle apply color to branch.

◆ onShowEmptyFoldersToggled

void qSlicerSubjectHierarchyFolderPlugin::onShowEmptyFoldersToggled ( bool )

protectedslot

Toggle empty folder visibility (.

See also: showEmptyHierarchyItems) in the sort filter proxy model of the current tree view.

◆ roleForPlugin()

Q_INVOKABLE const QString qSlicerSubjectHierarchyFolderPlugin::roleForPlugin ( ) const

overridevirtual

Get role that the plugin assigns to the subject hierarchy item. Each plugin should provide only one role.

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ sceneContextMenuActions()

QList< QAction * > qSlicerSubjectHierarchyFolderPlugin::sceneContextMenuActions ( ) const

overridevirtual

Get scene context menu item actions to add to tree view Separate method is needed for the scene, as its actions are set to the tree by a different method

See also: itemContextMenuActions

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ setApplyColorToBranchEnabledForItem()

void qSlicerSubjectHierarchyFolderPlugin::setApplyColorToBranchEnabledForItem	(	vtkIdType	itemID,
		bool	enabled )

protected

Determine if apply color to branch option is enabled to a given item or not.

◆ setDisplayColor()

void qSlicerSubjectHierarchyFolderPlugin::setDisplayColor	(	vtkIdType	itemID,
		QColor	color,
		QMap< int, QVariant >	terminologyMetaData )

overridevirtual

Set display color of an owned subject hierarchy item In case of folders only color is set but no terminology. The properties are not used directly, but only if applied to the branch (similarly to how it worked in model hierarchies).

Parameters

color	Display color to set
terminologyMetaData	Map containing terminology meta data. Not used in this plugin

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ setDisplayVisibility()

void qSlicerSubjectHierarchyFolderPlugin::setDisplayVisibility	(	vtkIdType	itemID,
		int	visible )

overridevirtual

Set display visibility of an owned subject hierarchy item.

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ showContextMenuActionsForItem()

void qSlicerSubjectHierarchyFolderPlugin::showContextMenuActionsForItem ( vtkIdType itemID )

overridevirtual

Show context menu actions valid for a given subject hierarchy item.

Parameters

itemID Subject Hierarchy item to show the context menu items for

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ showVisibilityContextMenuActionsForItem()

void qSlicerSubjectHierarchyFolderPlugin::showVisibilityContextMenuActionsForItem ( vtkIdType itemID )

overridevirtual

Show visibility context menu actions valid for a given subject hierarchy item.

Parameters

itemID Subject Hierarchy item to show the visibility context menu items for

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ updateShowEmptyFoldersAction()

void qSlicerSubjectHierarchyFolderPlugin::updateShowEmptyFoldersAction ( )

protected

Update show empty folders context menu item visibility and checked state. The update needs to happen in more than one place, which is handled by this method.

◆ visibilityContextMenuActions()

QList< QAction * > qSlicerSubjectHierarchyFolderPlugin::visibilityContextMenuActions ( ) const

overridevirtual

Get visibility context menu item actions to add to tree view. These item visibility context menu actions can be shown in the implementations of

See also: showVisibilityContextMenuActionsForItem

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

◆ visibilityIcon()

QIcon qSlicerSubjectHierarchyFolderPlugin::visibilityIcon ( int visible )

overridevirtual

Get visibility icon for a visibility state.

Reimplemented from qSlicerSubjectHierarchyAbstractPlugin.

Member Data Documentation

◆ d_ptr

QScopedPointer<qSlicerSubjectHierarchyFolderPluginPrivate> qSlicerSubjectHierarchyFolderPlugin::d_ptr

protected

Definition at line 185 of file qSlicerSubjectHierarchyFolderPlugin.h.

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

Modules/Loadable/SubjectHierarchy/Widgets/qSlicerSubjectHierarchyFolderPlugin.h

Public Types

Public Member Functions

Protected Slots

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Superclass

Constructor & Destructor Documentation

◆ qSlicerSubjectHierarchyFolderPlugin()

◆ ~qSlicerSubjectHierarchyFolderPlugin()

Member Function Documentation

◆ addNodeToSubjectHierarchy()

◆ canAddNodeToSubjectHierarchy()

◆ canOwnSubjectHierarchyItem()

◆ colorItemAttributeName()

◆ createDisplayNodeForItem()

◆ createFolderUnderCurrentNode

◆ createFolderUnderItem()

◆ createFolderUnderScene

◆ displayNodeForItem()

◆ editProperties()

◆ emptyFolderCreatedFromTreeView()

◆ getDisplayColor()

◆ getDisplayVisibility()

◆ icon()

◆ isApplyColorToBranchEnabledForItem()

◆ itemContextMenuActions()

◆ onApplyColorToBranchToggled

◆ onShowEmptyFoldersToggled

◆ roleForPlugin()

◆ sceneContextMenuActions()

◆ setApplyColorToBranchEnabledForItem()

◆ setDisplayColor()

◆ setDisplayVisibility()

◆ showContextMenuActionsForItem()

◆ showVisibilityContextMenuActionsForItem()

◆ updateShowEmptyFoldersAction()

◆ visibilityContextMenuActions()

◆ visibilityIcon()

Member Data Documentation

◆ d_ptr