Package com.nomagic.magicdraw.copypaste

Class CopyPasting

  • @OpenApiAll
public class CopyPasting
extends java.lang.Object

    Provides API for copy-pasting elements in the model and symbol styles in diagrams.

    You can copy model elements and symbols either to another location in the same project or to another project. This must be done in the same session. There are two modes of making copies of model elements:
    • Deep copying (with new data)
    • Shallow copying (with reused data)

    Example 1: Copying an element 

     Element element = ...; // Element to copy/paste.
 Element parent = ...;  // Parent to which the element has to be pasted: either the same project or another project.

 SessionManager sessionManager = SessionManager.getInstance();
 sessionManager.createSession("Clone");

 // 3rd parameter indicates whether element name uniqueness should be preserved in the parent.
 CopyPasting.copyPasteElement(element, parent, true);

 sessionManager.closeSession();

    Example 2: Copying multiple elements and symbols 

     List elements = ...; // Elements to copy/paste.
 List views = ...; // Symbols to copy/paste.
 Element parent = ...;  // Parent to which elements should be pasted: either the same project or another project.

 BaseElement symbolParent = ...; // Parent to which symbols should be pasted.

 SessionManager sessionManager = SessionManager.getInstance();
 sessionManager.createSession("Clone");

 // 4th parameter indicates whether deep or shallow copy is applied.
 // 5th parameter indicates whether element name uniqueness should be preserved in the parent.
 List baseElements = CopyPasting.copyPasteElements(views, parent, symbolParent, true, true);

 sessionManager.closeSession();

    Example 3: Copying style from one symbol to another 

     PresentationElement source = ...; // Symbol with symbol properties (style) to copy
 PresentationElement target = ...; // Symbol to paste style on

 SessionManager sessionManager = SessionManager.getInstance();
 sessionManager.createSession("Clone Symbol Style");

 CopyPasting.copyPasteSymbolsStyle(source, target)

 sessionManager.closeSession();

    Example 4: Copying style from symbol to multiple symbols 

     PresentationElement source = ...; // Symbol with symbol properties (style) to copy
 Collection targets = ...; // Symbols to paste style on

 SessionManager sessionManager = SessionManager.getInstance();
 sessionManager.createSession("Clone Symbol Style");

 CopyPasting.copyPasteSymbolsStyle(source, targets)

 sessionManager.closeSession();
    See Also:
    BaseElement, Element, PresentationElement, SessionManager

    • Constructor Detail

      • CopyPasting

        public CopyPasting()

    • Method Detail

      • copyPasteElement

        @CheckForNull
public static Element copyPasteElement​(Element elementToCopy,
                                       Element parent)
        Makes a copy of the specified element and places it under the parent (namespace). Does not increase element names in the given namespace.

        Assumes that session is started by SessionManager.

        Parameters:
        elementToCopy - element to copy.
        parent - owner to which to add copied element.
        Returns:
        cloned element.

      • copyPasteElement

        @CheckForNull
public static Element copyPasteElement​(Element elementToCopy,
                                       Element parent,
                                       boolean increaseElementNames)
        Makes a copy of the specified element and places it under the parent (namespace).

        Assumes that session is started by SessionManager.

        Parameters:
        elementToCopy - element to copy.
        parent - owner to which to add copied element.
        increaseElementNames - indicates if element names should be increased in given namespace to avoid duplication.
        Returns:
        cloned element.

      • copyPasteElements

        public static java.util.List copyPasteElements​(java.util.List<? extends Element> elementsToCopy,
                                               Element parent)
        Makes a copy of specified elements and places them under the given parent (namespace). Does not increase element names in the given namespace.

        Assumes that session is started by SessionManager.

        Parameters:
        elementsToCopy - collection of Element} objects to be copied.
        parent - parent where objects should be placed.
        Returns:
        list of copies.

      • copyPasteElements

        public static java.util.List copyPasteElements​(java.util.List<? extends Element> elementsToCopy,
                                               Element parent,
                                               boolean increaseElementNames)
        Makes a copy of specified elements and places them under the given parent (namespace).

        Assumes that session is started by SessionManager.

        Parameters:
        elementsToCopy - collection of Element} objects to be copied.
        parent - parent where objects should be placed.
        increaseElementNames - indicates if element names should be increased in given namespace to avoid duplication.
        Returns:
        list of copies.

      • copyPasteElements

        public static java.util.List<BaseElement> copyPasteElements​(java.util.Collection<? extends BaseElement> objectsToCopy,
                                                            @CheckForNull
                                                            BaseElement dataParent,
                                                            BaseElement viewParent,
                                                            boolean withNewData,
                                                            boolean increaseElementNames)
        Clones given objects (model elements or symbols) and establishes correct relationships. Returns correct copies. These copies can contain views and model elements (mixed).
        Parameters:
        objectsToCopy - objects to copy.
        dataParent - data parent.
        viewParent - parent of symbols.
        withNewData - indicates whether pasting should be done with new data (deep or shallow copy).
        increaseElementNames - indicates whether elements names should be increased.
        Returns:
        cloned elements.

      • copyPasteSymbolsStyle

        public static void copyPasteSymbolsStyle​(PresentationElement sourceSymbol,
                                         java.util.Collection<PresentationElement> targetSymbols)
                                  throws ReadOnlyElementException
        Copies symbol style from provided source symbol and pastes it on each target symbol.

        Assumes that session is started by SessionManager.

        Parameters:
        sourceSymbol - symbol to copy style from
        targetSymbols - symbols to paste style on
        Throws:
        ReadOnlyElementException - when any of the target symbols is read only or symbol's owner is read only.

      • copyPasteSymbolsStyle

        public static void copyPasteSymbolsStyle​(java.util.Collection<PresentationElement> sourceSymbols,
                                         java.util.Collection<PresentationElement> targetSymbols)
                                  throws ReadOnlyElementException
        Copies symbol style from one of the source symbols to target symbols. For each target symbol first found appropriate source symbol is selected. Symbols of the same element type are preferred.

        Assumes that session is started by SessionManager.

        Parameters:
        sourceSymbols - symbols to copy style from
        targetSymbols - symbols to paste style on
        Throws:
        ReadOnlyElementException - when any of the target symbols is read only or symbol's owner is read only.