ModelElement::ChooseMergeTarget Method (ElementGroupPrototype^)

 

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(
	ElementGroupPrototype^ elementGroupPrototype
)

Parameters

elementGroupPrototype
Type: Microsoft.VisualStudio.Modeling::ElementGroupPrototype^

The ElementGroupPrototype that will be reconstituted and merged with the target element.

Return Value

Type: Microsoft.VisualStudio.Modeling::ModelElement^

The ModelElement to use as the target for the merge process.

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: