ModelElement::ChooseMergeTarget Method (ElementGroup^)

 

Selects a target element to accept as its child an element that the user wants to copy, drag, or create.

Namespace:   Microsoft.VisualStudio.Modeling
Assembly:  Microsoft.VisualStudio.Modeling.Sdk.12.0 (in Microsoft.VisualStudio.Modeling.Sdk.12.0.dll)

protected:
virtual ModelElement^ ChooseMergeTarget(
	ElementGroup^ elementGroup
)

Parameters

elementGroup
Type: Microsoft.VisualStudio.Modeling::ElementGroup^

The group of source elements that will merge with the target element.

Return Value

Type: Microsoft.VisualStudio.Modeling::ModelElement^

The target element.

A merge operation is what happens when the user uses a tool to create a model element, or performs the paste command, or drags an element onto another. Merge combines the new or copied elements into the existing model.

This method is called when a merge is about to happen. It allows the target element to redirect the merge operation so that another element is the target. For example, a part of a larger object could redirect the merge operation to its parent. This is a benefit for the user, who does not have to distinguish between the part and its parent when dragging a tool or object.

The default method returns this element as the target.

Return to top
Show: