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.11.0 (in Microsoft.VisualStudio.Modeling.Sdk.11.0.dll)
Syntax
'Declaration
Protected Overridable Function ChooseMergeTarget ( _
elementGroup As ElementGroup _
) As ModelElement
protected virtual ModelElement ChooseMergeTarget(
ElementGroup elementGroup
)
protected:
virtual ModelElement^ ChooseMergeTarget(
ElementGroup^ elementGroup
)
abstract ChooseMergeTarget :
elementGroup:ElementGroup -> ModelElement
override ChooseMergeTarget :
elementGroup:ElementGroup -> ModelElement
protected function ChooseMergeTarget(
elementGroup : ElementGroup
) : ModelElement
Parameters
elementGroup
Type: Microsoft.VisualStudio.Modeling.ElementGroupThe group of source elements that will merge with the target element.
Return Value
Type: Microsoft.VisualStudio.Modeling.ModelElement
The target element.
Remarks
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.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.