com.nomagic.magicdraw.dependencymatrix.datamodel.editing

Interface DependencyEditor

@OpenApiAll
public interface DependencyEditor

Interface for mechanism, which is used to edit dependency matrix.

Value editors may be registered inside MatrixFactory Value editors define which matrix cells are editable, and may add new add/remove dependency actions according to provided context

NOTE: if canCreate returns false, no menu items will be created using createAddActions. The same applies to canEdit and createEditActions methods

Method Summary

Modifier and Type	Method and Description
default boolean	canCreate(PersistenceManager settings, Element row, Element column, AbstractMatrixCell cell) Deprecated. use canCreate(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell)
default boolean	canCreate(PersistenceManager settings, ElementNode row, ElementNode column, AbstractMatrixCell cell) Analyze specific cell and decides if there is any new dependencies which can be created for this pair of elements IMPORTANT: Make this method as fast as possible.
default boolean	canEdit(PersistenceManager persistenceManager, Element row, Element column, AbstractMatrixCell cell) Deprecated. use canEdit(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell)
default boolean	canEdit(PersistenceManager persistenceManager, ElementNode row, ElementNode column, AbstractMatrixCell cell) Analyze current cell, an decide if this there are at least one dependency, which can be deleted/edited.
void	clear() Purpose of this method to cleanup all unnecessary cache and objects
default void	createAddActions(PersistenceManager settings, Element row, Element column, AbstractMatrixCell cell, ActionsCategory mainCategory, ActionsCategory rowToColumn, ActionsCategory columnToRow) Deprecated. use createAddActions(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell, ActionsCategory, ActionsCategory, ActionsCategory)
default void	createAddActions(PersistenceManager settings, ElementNode row, ElementNode column, AbstractMatrixCell cell, ActionsCategory mainCategory, ActionsCategory rowToColumn, ActionsCategory columnToRow) Used to edit specific cell action categories when user initiates add relationships actions.
default void	createEditActions(PersistenceManager settings, Element row, Element column, AbstractMatrixCell cell, ActionsCategory main, ActionsCategory deleteActions) Deprecated. use createEditActions(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell, ActionsCategory, ActionsCategory)
default void	createEditActions(PersistenceManager settings, ElementNode row, ElementNode column, AbstractMatrixCell cell, ActionsCategory main, ActionsCategory deleteActions) Analyze current cell, and create actions which can remove/edit specific dependencies from this cell
void	elementUpdated(java.util.Collection<Element> element) This method is triggered when elements are updated but Build is not initiated.
void	init(PersistenceManager settings, org.eclipse.core.runtime.IProgressMonitor status) Initializes value editor.

Method Detail

init

void init(PersistenceManager settings,
          @CheckForNull
          org.eclipse.core.runtime.IProgressMonitor status)

Initializes value editor. This method is executed during matrix rebuild

Parameters:

settings - matrix settings

status - progress status

createAddActions

@Deprecated
default void createAddActions(PersistenceManager settings,
                                          Element row,
                                          Element column,
                                          AbstractMatrixCell cell,
                                          ActionsCategory mainCategory,
                                          ActionsCategory rowToColumn,
                                          ActionsCategory columnToRow)

Deprecated. use createAddActions(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell, ActionsCategory, ActionsCategory, ActionsCategory)

createAddActions

default void createAddActions(PersistenceManager settings,
                              ElementNode row,
                              ElementNode column,
                              AbstractMatrixCell cell,
                              ActionsCategory mainCategory,
                              ActionsCategory rowToColumn,
                              ActionsCategory columnToRow)

Used to edit specific cell action categories when user initiates add relationships actions. It may be either popup menu items or double click action

Parameters:

settings - matrix settings

row - row element

column - column element

cell - cell value

mainCategory - whole menu category

rowToColumn - column to row dependency category

columnToRow - row to column dependency category

createEditActions

@Deprecated
default void createEditActions(PersistenceManager settings,
                                           Element row,
                                           Element column,
                                           AbstractMatrixCell cell,
                                           ActionsCategory main,
                                           ActionsCategory deleteActions)

Deprecated. use createEditActions(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell, ActionsCategory, ActionsCategory)

createEditActions

default void createEditActions(PersistenceManager settings,
                               ElementNode row,
                               ElementNode column,
                               AbstractMatrixCell cell,
                               ActionsCategory main,
                               ActionsCategory deleteActions)

Analyze current cell, and create actions which can remove/edit specific dependencies from this cell

Parameters:

settings - matrix settings

row - row element

column - column element

cell - current cell

main - main action category

deleteActions - add remove dependency actions to this category

canCreate

@Deprecated
default boolean canCreate(PersistenceManager settings,
                                      Element row,
                                      Element column,
                                      @CheckForNull
                                      AbstractMatrixCell cell)

Deprecated. use canCreate(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell)

canCreate

default boolean canCreate(PersistenceManager settings,
                          ElementNode row,
                          ElementNode column,
                          @CheckForNull
                          AbstractMatrixCell cell)

Analyze specific cell and decides if there is any new dependencies which can be created for this pair of elements

IMPORTANT: Make this method as fast as possible. Performance of this method highly influences overall performance of the Dependency matrix component

Parameters:

settings - matrix settings

row - row element

column - column element

cell - matrix cell

Returns:

true if at least one relation can be created

canEdit

@Deprecated
default boolean canEdit(PersistenceManager persistenceManager,
                                    Element row,
                                    Element column,
                                    AbstractMatrixCell cell)

Deprecated. use canEdit(PersistenceManager, ElementNode, ElementNode, AbstractMatrixCell)

canEdit

default boolean canEdit(PersistenceManager persistenceManager,
                        ElementNode row,
                        ElementNode column,
                        AbstractMatrixCell cell)

Analyze current cell, an decide if this there are at least one dependency, which can be deleted/edited.

IMPORTANT: Make this method as fast as possible. Performance of this method highly influences overall performance of the Dependency matrix component

Parameters:

persistenceManager - matrix settings

row - row element

column - column element

cell - matrix cell

Returns:

true if there is at least one dependency which can be deleted.

elementUpdated

void elementUpdated(java.util.Collection<Element> element)

This method is triggered when elements are updated but Build is not initiated. All caches should be cleared

Parameters:

element - updated element

clear

void clear()

Purpose of this method to cleanup all unnecessary cache and objects