Paste from Project Browser

As well as creating new elements in the current diagram, you can add existing elements from the Project Browser to the diagram.

Access     Drag existing element onto the diagram
(If the Paste Element dialog does not display, press ( Ctrl ) while dragging the element)

Select Paste options

Field/Button

Detail

See also

Paste as

Click on the drop-down arrow and select one of the paste types:

Link - Paste the element as a simple link: in this case the one element is represented in the Project Browser and in any diagram to which it has been added; changes to the element are reflected in all diagrams in which it is shown
 
Instance - Paste a copy of the element as a separate instance of the original element, classified by the original element; this is useful when creating multiple instances of a Class in a Sequence diagram or Communication diagram
 
Invocation - Paste a copy of a State Machine or Activity element as an invocation of the source element; the resulting element is a State object or Action - respectively - with the source element as its classifier
 
Property - Paste a copy of the element as a separate Object instance
 
Child - Paste the element as a child of the copied element - that is, as a new  element (which you are prompted to name) with a Generalization connector back to the copied element; this is very useful when you have a Class library or framework from which you inherit new forms - for example, you can paste a Hashtable as "MyHashtable" which automatically becomes a child of the original Hashtable
 
Used with the Override Parent Operations feature, this is a quick way to create new structures based on frameworks such as the Java SDK and the .NET SDK

 

 

 

 

 

 

Classifiers and Instances

 

 

 

 

 

 

 

 

 

Override Parent Operations

Copy Connectors

This checkbox is enabled when you select to paste the copied element as an instance, property or invocation.

Select the checkbox to reproduce on the diagram any connectors between the original element and any other elements that have also been pasted to this diagram, as connectors between the instances.

 

 

Structural Elements

If the original element has any child elements (for example, if it is a composite element or nested element, or contains embedded elements) this field contains the value Select. Either:

Leave this value as is, so that when you click on the OK button the Structural Elements dialog displays, from which you can select the child elements to reproduce with the pasted element, or
Click on the drop-down arrow and select:
None to not reproduce any child elements
All to reproduce all child elements on the original element, or
Based on Instance <diagram names> to reproduce the configuration of child elements on an instance of the original element on another diagram, if there are any other instances

The resulting Object element is created large enough to display the selected child elements laid out neatly within the Object border.

 

 

Manage Structural Elements

Options

Click on this button to display a short menu from which you can select to:

Make your settings on this dialog the default for all drag and drop operations from the Project Browser, and
Display this dialog for drag and drop operations only if you press and hold ( Ctrl ) as you drag the element onto the diagram
 

If you select the Autosave selection as default option, this deselects the Auto Instance checkbox on the Diagram > Behavior page of the Options dialog. The automatic paste operation becomes whatever you have set on the Paste dialog, and is not overridden by the paste-as-instance imposed by the Auto Instance checkbox.

If you select the Use Ctrl + Mouse drag to display this dialog option, you can drag elements from the Project Browser without displaying the dialog; the paste operation complies with whatever settings you used the last time you opened the dialog. To change these settings, hold ( Ctrl ) as you drag an element, and edit the field values on the dialog.

 

 

 

 

 

 

Diagram Behavior

OK

Click on this button to complete the paste operation and close the dialog.

 

 

Cancel

Click on this button to cancel the paste operation and close the dialog.

 

 

Help

Click on this button to display this Help topic.

 

 

Notes

Not all paste options apply to all element types; for many types, the only option available is a Link
When an element dragged from the Project Browser is pasted into the diagram, its default style and size is applied rather than any alternative styles and sizes used for instances of the element in other diagrams

Learn more